Google People API が連絡先と連絡先グループの更新をサポート

この記事はソフトウェア エンジニア、Amos Yuen、G Suite デベロッパー アドボケート、Wesley Chun（@wescpy）による G Suite Developers Blog の記事 " Google People API now supports updates to Contacts and Contact Groups" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。


本日（*原文公開当時）より、Google People APIに連絡先と連絡先グループ用の新しいエンドポイントを追加しました。昨年、古い Contacts APIを置き換えることを念頭に、読み取り専用のエンドポイントに対応した Google People API をリリースしました。今回、書き込み用のエンドポイントを追加したことにより、その目的に一歩近づきました。デベロッパーが連絡先を作成、削除、更新できるようになっただけでなく、連絡先グループ用のエンドポイントも追加されているため、連絡先グループの読み書きもできるようになっています。

この API にアクセスするには、まずアプリケーションが認可を受ける必要があるため、Google Developers Consoleで People API を有効にしてプロジェクトを作成し、サービスにアクセスできるようにします。実行しなければならないステップについては、ここを参照してください。Google API や Developers Console にまだ慣れていない場合は、シリーズの第 1 弾であるこの動画を見て知識を深めておけば、すぐに追いつけます。


認可を受けると、以下のようにして簡単に（Java 向けの Google API クライアント ライブラリを使って）ユーザーの連絡先を作成できます。

Person contactToCreate = new Person();

List names = new ArrayList<>();
names.add(new Name().setGivenName("John").setFamilyName("Doe"));
contactToCreate.setNames(names);

Person createdContact =
    peopleService.people().createContact(contactToCreate).execute();

アプリは、https://www.googleapis.com/auth/contactsのスコープで認可を受けている必要があります。 people.create メソッドの詳細を記述したドキュメントは、ここから参照できます。既存の連絡先は、以下のようにして更新できます。

String resourceName = "people/c12345"; // existing contact resource name
Person contactToUpdate = peopleService.people().get(resourceName)
    .setPersonFields("names,emailAddresses")
    .execute();

List emailAddresses = new ArrayList<>();
emailAddresses.add(new EmailAddress().setValue("john.doe@gmail.com"));
contactToUpdate.setEmailAddresses(emailAddresses);

Person updatedContact = peopleService.people().updateContact(contactToUpdate)
    .setUpdatePersonFields("emailAddresses")
    .execute();

 people.update メソッドの詳細を記述したドキュメントは、ここから参照できます。連絡先を変更できるこの新機能を使って皆様が作るアプリを楽しみにしています。People API の詳細については、ここから公式ドキュメントを参照してください。


Reviewed by Eiji Kitamura - Developer Relations Team