Class ContactGroup

Deprecated. This function is deprecated and should not be used in new scripts.

Adds the given contact to this group

// The code below creates a new contact and adds it to the "Work Friends"
// contact group
constcontact=ContactsApp.createContact(
'John',
'Doe',
'john.doe@example.com',
);
constgroup=ContactsApp.getContactGroup('Work Friends');
group.addContact(contact);

Parameters

Return

(削除) ContactGroup (削除ここまで) — this contact group

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

See also

• (削除) removeContact(contact) (削除ここまで)

Deprecated. This function is deprecated and should not be used in new scripts.

Deletes this contact group.

Deletes non-system groups only; system groups cannot be deleted.

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

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

See also

• (削除) isSystemGroup() (削除ここまで)

Deprecated. This function is deprecated and should not be used in new scripts.

Gets all the contacts in this contact group.

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

Return

(削除) Contact[] (削除ここまで) — the contacts in this group

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

Deprecated. This function is deprecated and should not be used in new scripts.

Returns the name of this group.

Return

String — the name of this group

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

Deprecated. This function is deprecated and should not be used in new scripts.

Gets the id of this contact group.

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

Return

String — the id of this group

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

Deprecated. This function is deprecated and should not be used in new scripts.

Gets the name of this contact group.

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

Return

String — this name of this contact group

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

See also

• (削除) setName(name) (削除ここまで)

Deprecated. This function is deprecated and should not be used in new scripts.

Gets a boolean value to determine whether this contact group is a system group (undeletable) or not.

Systems groups are a set of groups that are predefined in Google Contacts, such as "My Contacts", "Family", "Coworkers", etc. The name of a system group usually contains the words "System Group".

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

Return

Boolean — whether or not this contact group is a system group

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

Deprecated. This function is deprecated and should not be used in new scripts.

Removes the given contact from this group

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

Parameters

Return

(削除) ContactGroup (削除ここまで) — this contact group

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

See also

• (削除) addContact(contact) (削除ここまで)

Deprecated. This function is deprecated and should not be used in new scripts.

Sets the name of this group.

Parameters

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

Deprecated. This function is deprecated and should not be used in new scripts.

Sets the name of this contact group.

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

Parameters

Return

(削除) ContactGroup (削除ここまで) — this contact group

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

See also

• (削除) getName() (削除ここまで)