e-mailアドレスをキーに連絡先を取得する

連絡先を e-mail アドレスをキーにして検索・取得する為には、ContactsApp クラスの
getContact メソッドを用いる。
  
  
【構文】
ContactsApp.getContact(email)
  
email : String 型。検索対象となる連絡先の e-mail アドレスを指定する。
戻り値 : Contact 型。引数で指定した e-mail アドレスをもつ連絡先を返す。該当する
           連絡先が存在しない場合は null を返す。
  
  
「連絡先の全ての e-mail アドレスを取得する」の項同様、下図の連絡先が登録され
ているものとし、アドレス
  
oraora@yahoo.co.jp
  
に合致するアドレスをもつ連絡先を取得する例を以下に記す :
  

  

  
  
【例】
function GetContact() {
  var objContact = ContactsApp.getContact("oraora@yahoo.co.jp");
  if (objContact == null) {
    Browser.msgBox("該当する連絡先がありません"); 
  }
  else {
    Browser.msgBox(objContact.getFullName());
  }
}
  
上記コードを実行するとメッセージボックスに
  
雨古太一
  
と表示される。ちなみに、登録されていないアドレス、例えば、
  
butabuta@yahoo.co.jp
  
で検索すると、(そんなアドレスをもつ連絡先は存在しないため)
  
該当する連絡先がありません
  
というメッセージが表示される。