2012年8月6日月曜日

既存の連絡先グループを取得する

既に登録されている連絡先グループを取得する場合には、ContactsApp クラスの
getContactGroup メソッドを使用する。
  
  
【構文】
ContactsApp.getContactGroup(name)
  
name : string 型。取得したいグループ名を指定する。
戻り値 : ContactGroup 型。引数で指定された ContactGroup オブジェクトが返される。
            存在しない場合は null が返される。
  
  
『新規ラベルを作成する』の項で登録した連絡先グループ「江戸時代」を取得するサンプル
コードを以下に記す。
  
  
【例】
function GetContactGroup() {
  var objContactGroup = ContactsApp.getContactGroup("江戸時代");
  if (objContactGroup == null) {
    Browser.msgBox("該当するグループがありません"); 
  }
  else {
    Browser.msgBox("グループが存在します"); 
  }
}
  
  
実行の結果、「グループが存在します」とメッセージボックスに表示される。

0 件のコメント:

コメントを投稿