Class ContactGroup

ContactGroup

非推奨。代わりに、People API Advanced の サービス

ContactGroup は連絡先のグループです。

サポート終了のメソッド

メソッド	戻り値の型	概要
addContact(contact)	ContactGroup	指定した連絡先をこのグループに追加します
deleteGroup()	void	この連絡先グループを削除します。
getContacts()	Contact[]	この連絡先グループ内のすべての連絡先を取得します。
getGroupName()	String	このグループの名前を返します。
getId()	String	この連絡先グループの ID を取得します。
getName()	String	この連絡先グループの名前を取得します。
isSystemGroup()	Boolean	この連絡先グループがシステム グループ（削除不可）かどうかを決定するブール値を取得します。 できません。
removeContact(contact)	ContactGroup	指定した連絡先をこのグループから削除します
setGroupName(name)	void	このグループの名前を設定します。
setName(name)	ContactGroup	この連絡先グループの名前を設定します。

サポート終了のメソッド

addContact(contact)

非推奨。この関数は非推奨のため、新しいスクリプトでは使用しないでください。

指定した連絡先をこのグループに追加します

// The code below creates a new contact and adds it to the "Work Friends" contact group
var contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');
var group = ContactsApp.getContactGroup('Work Friends');
group.addContact(contact);

パラメータ

名前	型	説明
contact	Contact	グループに追加する連絡先

戻る

ContactGroup - この連絡先グループ

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

• https://www.google.com/m8/feeds

関連情報

• removeContact(contact)

---

deleteGroup()

非推奨。この関数は非推奨のため、新しいスクリプトでは使用しないでください。

この連絡先グループを削除します。

システム以外のグループのみを削除します。削除することはできません。

// The code below retrieves a contact group named "Work Friends" and deletes it
var group = ContactsApp.getContactGroup('Work Friends');
group.deleteGroup();

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

• https://www.google.com/m8/feeds

関連情報

• isSystemGroup()

---

getContacts()

非推奨。この関数は非推奨のため、新しいスクリプトでは使用しないでください。

この連絡先グループ内のすべての連絡先を取得します。

// The code below retrieves all the contacts in the group named "Work Friends"
var group = ContactsApp.getContactGroup('Work Friends');
var contacts = group.getContacts();

戻る

Contact[] - このグループの連絡先

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

• https://www.google.com/m8/feeds

---

getGroupName()

非推奨。この関数は非推奨のため、新しいスクリプトでは使用しないでください。

このグループの名前を返します。

戻る

String - このグループの名前

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

• https://www.google.com/m8/feeds

---

getId()

非推奨。この関数は非推奨のため、新しいスクリプトでは使用しないでください。

この連絡先グループの ID を取得します。

// The code below retrieves a contact group named "Work Friends" and gets its id
var group = ContactsApp.getContactGroup('Work Friends');
var id = group.getId();

戻る

String - このグループの ID

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

• https://www.google.com/m8/feeds

---

getName()

非推奨。この関数は非推奨のため、新しいスクリプトでは使用しないでください。

この連絡先グループの名前を取得します。

// The code below creates a new contact group and then retrieves its name
var group = ContactsApp.createContactGroup('Work Friends');
var name = group.getName();

戻る

String - この連絡先グループの名前

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

• https://www.google.com/m8/feeds

関連情報

• setName(name)

---

isSystemGroup()

非推奨。この関数は非推奨のため、新しいスクリプトでは使用しないでください。

この連絡先グループがシステム グループ（削除不可）かどうかを決定するブール値を取得します。 できません。

システム グループは、Google コンタクトで事前に定義されている一連のグループです。 「連絡先」、「家族」、「同僚」など。通常、システム グループの名前には、 「システム グループ」。

// The code below retrieves two contact groups, then logs whether or not
// each is a system group.
var myGroup = ContactsApp.getContactGroup('Work Friends');
var systemGroup = ContactsApp.getContactGroup('System Group: Coworkers');
Logger.log(myGroup.isSystemGroup()); // Returns false, if the group exists.
Logger.log(systemGroup.isSystemGroup()); // Returns true.

戻る

Boolean - この連絡先グループがシステム グループかどうか

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

• https://www.google.com/m8/feeds

---

removeContact(contact)

非推奨。この関数は非推奨のため、新しいスクリプトでは使用しないでください。

指定した連絡先をこのグループから削除します

// The code below retrieves all the contacts named "John Doe' and removes them from the
// "Work Friends" contact group
var contacts = ContactsApp.getContactsByName('John Doe');
var group = ContactsApp.getContactGroup('Work Friends');
for (var i in contacts) {
  group.removeContact(contacts[i]);
}

パラメータ

名前	型	説明
contact	Contact	グループから削除する連絡先

戻る

ContactGroup - この連絡先グループ

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

• https://www.google.com/m8/feeds

関連情報

• addContact(contact)

---

setGroupName(name)

非推奨。この関数は非推奨のため、新しいスクリプトでは使用しないでください。

このグループの名前を設定します。

パラメータ

名前	型	説明
name	String	このグループに設定する名前

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

• https://www.google.com/m8/feeds

---

setName(name)

非推奨。この関数は非推奨のため、新しいスクリプトでは使用しないでください。

この連絡先グループの名前を設定します。

// The code below retrieves the contact group named "Work Friends" and renames it to
// "Work Buddies"
var group = ContactsApp.getContactGroup('Work Friends');
group.setName('Work Buddies');

パラメータ

名前	型	説明
name	String	連絡先グループの新しい名前

戻る

ContactGroup - この連絡先グループ

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

• https://www.google.com/m8/feeds

関連情報

• getName()