Googleコンタクトにアクセスする (3/5)

では、取得されたContactGroupやContactにはどのような情報が保管されているのでしょうか。これも、主なメソッド類をざっと整理していきましょう。といっても、特にContactはメソッド数が多いので、何ページかに分けて説明していきましょう。

○ContactGroupのメソッド

・ID、名前に関するもの

変数 =《ContactGroup》.getId();
変数 =《ContactGroup》.getName();
《ContactGroup》.setName( 名前 );

・所属するContactを得る

変数 =《ContactGroup》.getContacts();

・Contactの追加・除去

《ContactGroup》.addContact( Contactオブジェクト );
《ContactGroup》.removeContact( Contactオブジェクト );

・ContactGroupの削除

《ContactGroup》.deleteGroup();

ContactGroupのメソッドは、以上です。基本的に「IDや名前に関するもの」「含まれるContactに関するもの」で、比較的シンプルですね。これに対し、Contactは非常に多くのメソッドが含まれています。Contactに、連絡先のあらゆる情報が保管されますからこれはやむを得ないでしょう。ここでは、単純な値として取り出せるものだけあげておきます。

○Contactの主なメソッド

・ID、名前に関するもの

変数 =《Contact》.getId();
変数 =《Contact》.getFullName();
《Contact》.setFullName( テキスト );
変数 =《Contact》.getShortName();
《Contact》.setShortName( テキスト );
変数 =《Contact》.getFamilyName();
《Contact》.setFamilyName( テキスト );
変数 =《Contact》.getMiddleName();
《Contact》.setMiddleName( テキスト );
変数 =《Contact》.getGivenName();
《Contact》.seGivenName( テキスト );
変数 =《Contact》.getNickname();
《Contact》.setNickname( テキスト );
変数 =《Contact》.getMaidenName();
《Contact》.setMaidenName( テキスト );
変数 =《Contact》.getInitials();
《Contact》.setInitials( テキスト );
変数 =《Contact》.getPrefix();
《Contact》.setPrefix( テキスト );
変数 =《Contact》.getSuffix();
《Contact》.setSuffix( テキスト );

・メモに関するもの

変数 =《Contact》.getNotes();
《Contact》.setNotes( テキスト );

・ContactGroupに関するもの

《Contact》.addToGroup( ContactGroupオブジェクト );
《Contact》.removeFromGroup( ContactGroupオブジェクト );

・Contactの削除

《Contact》.deleteContact();

名前に関するものだけでもずいぶんとたくさんのメソッドが要されていることがわかるでしょう。通常の名前、フルネーム、名字、ミドルネーム、イニシャル、ニックネーム……とにかく細々とした項目が用意されているため、それらを利用するメソッドだけでこんなになるのですね。

とりあえず、これらの比較的シンプルなメソッドの利用例についてあげておきましょう。下のリストは、メールアドレスを入力すると、その連絡先の情報をログに出力するサンプルです。アクティブシートにBrowser.inputBoxで入力ダイアログを表示し、Logger.logで情報を書きだしています。実際にいろいろと試してみて、出力内容を確認してみましょう。

(by. SYODA-Tuyano.)

※リストが表示されない場合

AddBlockなどの広告ブロックツールがONになっているとリストなどが表示されない場合があります。これらのツールをOFFにしてみてください。

function getContact(){
  var str = Browser.inputBox("メールアドレスを入力：");
  var contact = ContactsApp.getContact(str);
  if (contact != undefined){
    Logger.log("ID:" + contact.getId());
    Logger.log("Name:" + contact.getShortName());
    Logger.log("Name:" + contact.getFullName());
    Logger.log("Initials:" + contact.getInitials());
    
    var groups = contact.getContactGroups();
    for(var i = 0;i < groups.length;i++){
      Logger.log("Group ID:" + groups[i].getId());
      Logger.log("Group Name:" + groups[i].getName());
    }
  }
}