Veraltet. Verwenden Sie stattdessen den erweiterten Dienst People API
Eine Kontaktgruppe ist eine Gruppe von Kontakten.
Verworfene Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
|
| Fügt den angegebenen Kontakt zu dieser Gruppe hinzu |
| void | Löscht diese Kontaktgruppe. |
|
| Ruft alle Kontakte in dieser Kontaktgruppe ab. |
| String | Gibt den Namen dieser Gruppe zurück |
| String | Ruft die ID der Kontaktgruppe ab. |
| String | Ruft den Namen dieser Kontaktgruppe ab. |
| Boolean | Ruft einen booleschen Wert ab, um zu bestimmen, ob diese Kontaktgruppe eine Systemgruppe (nicht löschbar) ist oder nicht. |
|
| Entfernt den angegebenen Kontakt aus dieser Gruppe |
| void | Legt den Namen der Gruppe fest. |
|
| Legt den Namen dieser Kontaktgruppe fest. |
Verworfene Methoden
addContact(contact)
addContact(contact)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Fügt den angegebenen Kontakt zu dieser Gruppe hinzu
// The code below creates a new contact and adds it to the "Work Friends" contact group var contact = ContactsApp.createContact('John', 'Doe', 'john.doe@example.com'); var group = ContactsApp.getContactGroup('Work Friends'); group.addContact(contact);
Parameter
Name | Typ | Beschreibung |
---|---|---|
contact |
| der Kontakt, der der Gruppe hinzugefügt werden soll |
Return
– diese KontaktgruppeContactGroup
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
deleteGroup()
deleteGroup()
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Löscht diese Kontaktgruppe.
Löscht nur systemfremde Gruppen. Systemgruppen können nicht gelöscht werden.
// The code below retrieves a contact group named "Work Friends" and deletes it var group = ContactsApp.getContactGroup('Work Friends'); group.deleteGroup();
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContacts()
getContacts()
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Ruft alle Kontakte in dieser Kontaktgruppe ab.
// The code below retrieves all the contacts in the group named "Work Friends" var group = ContactsApp.getContactGroup('Work Friends'); var contacts = group.getContacts();
Return
– die Kontakte in dieser GruppeContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
getGroupName()
getGroupName()
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Gibt den Namen dieser Gruppe zurück
Return
String
– der Name dieser Gruppe
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
getId()
getId()
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Ruft die ID der Kontaktgruppe ab.
// The code below retrieves a contact group named "Work Friends" and gets its id var group = ContactsApp.getContactGroup('Work Friends'); var id = group.getId();
Return
String
– die ID dieser Gruppe
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
getName()
getName()
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Ruft den Namen dieser Kontaktgruppe ab.
// The code below creates a new contact group and then retrieves its name var group = ContactsApp.createContactGroup('Work Friends'); var name = group.getName();
Return
String
: der Name der Kontaktgruppe
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
isSystemGroup()
isSystemGroup()
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Ruft einen booleschen Wert ab, um zu bestimmen, ob diese Kontaktgruppe eine Systemgruppe (nicht löschbar) ist oder nicht.
Systemgruppen sind Gruppen, die in Google Kontakte vordefiniert sind, z. B. "Meine Kontakte", "Familie", "Kollegen" usw. Der Name einer Systemgruppe enthält normalerweise die Wörter "Systemgruppe".
// 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.
Return
Boolean
– gibt an, ob diese Kontaktgruppe eine Systemgruppe ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
removeContact(contact)
removeContact(contact)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Entfernt den angegebenen Kontakt aus dieser Gruppe
// 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]); }
Parameter
Name | Typ | Beschreibung |
---|---|---|
contact |
| der Kontakt, der aus der Gruppe entfernt werden soll |
Return
– diese KontaktgruppeContactGroup
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
setGroupName(name)
setGroupName(name)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Legt den Namen der Gruppe fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
name | String | Name, der für diese Gruppe festgelegt werden soll |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
setName(name)
setName(name)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Legt den Namen dieser Kontaktgruppe fest.
// 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');
Parameter
Name | Typ | Beschreibung |
---|---|---|
name | String | den neuen Namen für die Kontaktgruppe |
Return
– diese KontaktgruppeContactGroup
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds