GoogleAppScriptのContactsAppクラスが廃止されたかどうかについて

Question

2021/6/15にGoogle ContactsAPIが廃止されたようです。
これに伴ってか、下記の様なContactsAppクラスを利用したGASを実行するとエラーをたまに吐くようになってしまいました。
毎回エラーになる訳では無く、また公式にContactsAppが廃止された情報は見当たらないのですが、
ContactsAppクラスがContactsAPIのラッパーであるならばやはり廃止と見た方が良いのでしょうか。
しかしエラーになったりならなかったりする理由が分かりません。移行期間ということでランダムにエラーを返しているのでしょうか？

またContactsAPIの後継としてPeopleAPIが提供されていますが、ContactsAppの後継となるようなクラスはあるのでしょうか。

funcion getName(){
 var name =  ContactsApp.getContact("メールアドレス").getFamilyName();
}

実行結果※エラーになる場合とならない場合がある

Exception: サービス エラー: ContactsApp: Contacts API is being deprecated. Migrate to People API to retain 
programmatic access to Google Contacts. See 
https://developers.google.com/people/contacts-api-migration.

ご教示の程よろしくお願い致します。

Answer 1

私の環境ではエラーが再現できなかったので、理由はわかりかねますが、エラー文を見る限りではGoogle ContactsAPI廃止に伴う不具合とみて間違いないと思います。
ContactsAppについて今後修正が入るのか、廃止されるのかされるとは思います。

正確なのはPeopleAPIを利用してしまう方法で、サービスよりPeopleAPIを追加して利用します。

Comments

[wefee]

GASでPeopleAPIを叩くコードのサンプルがなかなか見つからず、手探り状態でしたがやりたいことは実現できました。高速化もできてよかったです。ありがとうございました。

Answer 2

サービスからPeopleAPIを追加して…というご回答を頂いたので、
こちらのリファレンスを参考にコードを書き直してみました。
ContactAppよりかなり速いですね。

var key = "検索するメールアドレスor名前"
function GetPeople(key) {
  var people = People.People.searchContacts({
    query: key,
    pageSize: 1,　//複数マッチ時に何件返すか 最大10件？
    readMask: "names,emailAddresses,organizations"　//取得するフィールド
  });
  var name = people.results[0].person.names[0].familyName;　//苗字
  var address = people.results[0].person.emailAddresses[0].value;　//メールアドレス
  var org = people.results[0].person.organizations[0].name;　//組織
}