×

[PR]この広告は3ヶ月以上更新がないため表示されています。
ホームページを更新後24時間以内に表示されなくなります。


Googleを追いかけろ!

.

参照ページ(Goolge)


WWW を検索 Googleを追いかけろ! を検索
class ContactsApp : Members
memberType説明
createContact Contact ContactsAppに新しい連絡先を作成する
createContactGroup ContactGroup 連絡先グループを作成する
deleteContact ContactsAppから連絡先を削除する
deleteContactGroup ContactsAppから連絡先グループを削除する
findbyEmailAddress Contact 指定されたメールアドレスの連絡先を検索する
findContactGroup ContactGroup 指定された名前の連絡先グループを検索する
getAllContacts Contact [ ] ContactsApp内のすべての連絡先を取得する
getContactGroups ContactGroups[] ContactsApp内の連絡先グループの完全なリストを取得する



method createContact(firstName, lastName, emailAddress)

  • ContactsAppに新しい連絡先を作成する
    ( 参考 :deleteContact)
Arguments :
nameType説明
firstNameString 連絡先の名
lastNameString 連絡先の姓
emailAddressString 連絡先のメールアドレス
戻り値 :
Type説明
Contact 新しく作られた連絡先オブジェクト
Googleのサンプル :
var c = ContactsApp.createContact('Fido','McDog', 'fido@example.com');
var contact = ContactsApp.findByEmailAddress('fido@example.com');
Browser.msgBox (contact.getFullName());
動作確認用サンプル :
// 新規連絡先を作成して、そのフルネームを取得表示
// 新規(指定グループなし)で作成した連絡先(Gamil内)は”その他の連絡先”に作成される
// first name, last nameは両方必須

function createContact() {

var c = ContactsApp.createContact('Gmail','連絡先', 'test@example.com');
var contact = ContactsApp.findByEmailAddress('test@example.com');
Browser.msgBox (contact.getFullName());

}

20101025


method createContactGroup(name)

Arguments :
nameType説明
nameString 作成する連絡先グループの名前
戻り値 :
Type説明
ContactGroup 新しく作られた連絡先グループ
Googleのサンプル :
var group = ContactsApp.createContactGroup("Pets");
group.addContact(ContactsApp.createContact('Fido','McDog', 'fido@example.com'));
動作確認用サンプル :
// 連絡先に"My Group"グループを作成して
// スプレッドシートから一名をグループに追加

function createContactGroup(){
 

  var mysheet = SpreadsheetApp.getActiveSheet(); 
    var gname = mysheet.getRange("D2").getValue();
  var   name1 = mysheet.getRange("A2").getValue();
  var   name2 = mysheet.getRange("B2").getValue();
   var     ad = mysheet.getRange("C2").getValue();
  
   var  group = ContactsApp.createContactGroup(gname);
  group.addContact(ContactsApp.createContact(name1,name2,ad));

}
使用したスプレッドシート; 実行結果;

20101110


method deleteContact(contact)

  • ContactsAppから連絡先を削除する
    ( 参考 :createContact)
Arguments :
nameType説明
contactContact 作成する連絡先グループの名前
戻り値 :
Type説明
ContactGroup 削除すべき連絡先
Googleのサンプル :
var contact = ContactsApp.findByEmailAddress('fido@example.com');
contact.deleteContact();
動作確認用サンプル :
//所属グループに関係なく指定メールアドレスの連絡先を削除する

function deleteContact(){
var contact = ContactsApp.findByEmailAddress('test@example.com');
contact.deleteContact();
}

20101213


method deleteContactGroup(group)

Arguments :
nameType説明
groupContactGroup 削除する連絡先グループ
サンプル :
var group = ContactsApp.createContactGroup("Pets");
group.addContact(ContactsApp.createContact('Fido','McDog', 'fido@example.com'));
ContactsApp.deleteContactGroup(group);


method findbyEmailAddress(address)

  • 指定されたメールアドレスの連絡先を検索する
    ( 参考 :getAllContacts)
Arguments :
nameType説明
addressString 探すべき連絡先のメールアドレス
戻り値 :
Type説明
Contact メールアドレスを含む連絡先
Googleのサンプル :
var contact = ContactsApp.findByEmailAddress('fido@example.com');
Browser.msgBox (contact.getFullName());
動作確認用サンプル :
// 指定アドレスによって連絡先名を検索し表示する
//このアドレス誰だったけ?なんてときとか、メールの宛先に流し込んだり。。いろいろ活用できそう。

function findByEmailAddress(){

var contact = ContactsApp.findByEmailAddress('test@example.com');
Browser.msgBox (contact.getFullName());

}

20101213


method findContactGroup(name)

  • 指定された名前の連絡先グループを検索する
Arguments :
nameType説明
nameString 探すべき連絡先グループの名前
戻り値 :
Type説明
ContactGroup 該当する連絡先グループ
Googleのサンプル :
var group = ContactsApp.findContactGroup("Pets");
動作確認用サンプル1 :
// "TEST2"というグループ名を検索し見つからない時は表示

function findGroup(){

  var target = "TEST2";
  var findby = ContactsApp.findContactGroup(target); 
  if(findby == null){
    Browser.msgBox ("連絡先グループ" + target + "はありません。");
  }
}
動作確認用サンプル2 :
//連絡先グループを抽出し、新規の連絡先を追加する

function findContactGroup2(){

var findby = ContactsApp.findContactGroup("TEST");
var contact = ContactsApp.createContact('新規','連絡先', 'new@example.com');
contact.addToGroup(findby);
Browser.msgBox ("新しい連絡先を追加しました。");

}
動作確認用サンプル3 :
//インプットボックスに検索対象グループ名を入力させる
//見つからない場合は新規作成のためのグループ名を入力するように指示する
//グループを作成して新規の連絡先を追加(ここもインプットボックスで入力させると良いでしょうね)

function findElse(){
  var target = Browser.inputBox("連絡先グループを検索します。グループ名を入力してください。",Browser.Buttons.OK_CANCEL);
  var findby = ContactsApp.findContactGroup(target);
  if(findby == null){
    Browser.msgBox ("連絡先グループ" + target + "はありません。");
    var newGrp = Browser.inputBox("新規連絡先グループを作成します。グループ名を入力してください。",
                                                                                    Browser.Buttons.OK_CANCEL);
    var group = ContactsApp.createContactGroup(newGrp);
    group.addContact(ContactsApp.createContact('Mr.','New', 'add@example.com'));
  }
  else{
    Browser.msgBox ("連絡先グループ" + target + "が見つかりました。"); //検索対象グループ名が見つかった時の表示
    }
}

20101213


method getAllContacts()

戻り値 :
Type説明
Contact [ ] すべての連絡先
Googleのサンプル :
var contacts = ContactsApp.getAllContacts();
for (var i in contacts) {
  var contact = contacts[i];
  var name = contact.getFullName();
  Browser.msgBox(name);
}
動作確認用サンプル :
// すべての連絡先をlogに出力
function getAllContacts() {
var contacts = ContactsApp.getAllContacts();
for (var i in contacts) {
  var contact = contacts[i];
  var name = contact.getFullName();
  Logger.log (name);
 }
}

20110127


method getContactGroups()

  • ContactsApp内の連絡先グループの完全なリストを取得する
    ContactsAppには連絡先のリストのみならず潜在的に連絡先グループのリストも含まれている。各連絡先グループは連絡先を持つことができる。 このメソッドはすべての連絡先グループのリストを返す。
戻り値 :
Type説明
ContactGroups[ ] すべての連絡先グループ
Googleのサンプル :
var groups = ContactsApp.getContactGroups();
for (var i in groups) 
  Logger.log (groups[i].getGroupName());
動作確認用サンプル :
// すべての連絡先グループをlogに出力
function getContactGroups() {
var groups = ContactsApp.getContactGroups();
  for (var i in groups) {
  Logger.log (groups[i].getGroupName());
  }
}

20110127