Veraltet. Verwenden Sie stattdessen den erweiterten Dienst People API
Mit dieser Klasse können Nutzer auf ihre eigenen Google Kontakte zugreifen und darin aufgeführte Kontakte erstellen, entfernen und aktualisieren.
Verworfene Attribute
Property | Typ | Beschreibung |
---|---|---|
ExtendedField |
| |
Field |
| |
Gender |
| |
Month | Month | |
Priority |
| |
Sensitivity |
|
Verworfene Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
|
| Erstellt einen neuen Kontakt. |
|
| Erstellt eine Kontaktgruppe mit dem angegebenen Namen |
| void | Löscht den Kontakt. |
| void | Die Kontaktgruppe wird gelöscht. |
|
| Kontakt mit der angegebenen E-Mail-Adresse suchen |
|
| Findet eine Kontaktgruppe mit dem angegebenen Namen. |
|
| Ruft alle Kontakte ab, die zu diesem Nutzer gehören. |
|
| Ruft einen Kontakt über die E-Mail-Adresse ab. |
|
| Ruft den Kontakt mit dieser ID ab. |
|
| Ruft eine Kontaktgruppe mit dem angegebenen Namen ab oder gibt null zurück, wenn keine solche Kontaktgruppe gefunden wird. |
|
| Ruft eine Kontaktgruppe mit der angegebenen ID ab oder gibt null zurück, wenn keine solche Kontaktgruppe gefunden wird. |
|
| Ruft die vollständige Liste der Kontaktgruppen des Nutzers ab. |
|
| Ruft alle Kontakte des Nutzers ab. |
|
| Kontakte für eine Adresse abrufen. |
|
| Hiermit können Sie Kontakte abrufen, die mit einer Adresse übereinstimmen und auf ein bestimmtes Feld beschränkt sind. |
|
| Hiermit werden Kontakte für eine Adresse abgerufen, die auf das angegebene benutzerdefinierte Adresslabel beschränkt ist. |
|
| Kontakte abrufen, die dem Unternehmensfeld entsprechen. |
|
| Kontakte abrufen, die mit einem bestimmten Wert in einem benutzerdefinierten Feld übereinstimmen. |
|
| Ruft Kontakte für ein bestimmtes Standardfeld mit einem bestimmten Monat und Tag ab. |
|
| Sie können Kontakte für ein bestimmtes Standardfeld nach Monat, Tag und Jahr abrufen. |
|
| Sie können Kontakte für ein bestimmtes benutzerdefiniertes Feld für einen bestimmten Monat, einen bestimmten Tag und ein bestimmtes Jahr abrufen. |
|
| Rufen Sie Kontakte für ein bestimmtes benutzerdefiniertes Feld für einen bestimmten Monat und Tag ab. |
|
| Hiermit können Sie Kontakte abrufen, die mit einer E-Mail-Adresse übereinstimmen. |
|
| Hiermit können Sie Kontakte abrufen, die mit einer E-Mail-Adresse übereinstimmen und auf ein bestimmtes Feld beschränkt sind. |
|
| Hiermit werden Kontakte abgerufen, die mit einer E-Mail-Adresse übereinstimmen, die auf das angegebene Label der benutzerdefinierten E-Mail-Adresse beschränkt ist. |
|
| Ruft die Kontakte in einer bestimmten Kontaktgruppe ab. |
|
| Hiermit können Sie Kontakte abrufen, die mit einer Instant-Messaging-Adresse übereinstimmen. |
|
| Hiermit können Sie Kontakte abrufen, die einer Instant-Messaging-Adresse entsprechen, die auf ein bestimmtes Feld beschränkt sind. |
|
| Hiermit werden Kontakte abgerufen, die einer Instant Messaging-Adresse entsprechen, die auf das angegebene benutzerdefinierte Instant Messaging-Label beschränkt ist. |
|
| Kontakte abrufen, die mit dem Feld für die Stellenbezeichnung übereinstimmen. |
|
| Kontakte mit einem bestimmten Namen abrufen. |
|
| Hiermit können Sie Kontakte abrufen, die einem Namen entsprechen, beschränkt auf ein bestimmtes Feld. |
|
| Kontakte für das Notizenfeld abrufen. |
|
| Sie können Kontakte abrufen, die mit einer Telefonnummer übereinstimmen. |
|
| Hiermit können Sie Kontakte abrufen, die mit einer Telefonnummer übereinstimmen, die auf ein bestimmtes Feld beschränkt ist. |
|
| Hiermit werden Kontakte abgerufen, die mit einer Telefonnummer übereinstimmen, die auf das angegebene benutzerdefinierte Telefonnummernlabel beschränkt ist. |
|
| Hiermit werden Kontakte für eine URL abgerufen. |
|
| Hiermit können Sie Kontakte abrufen, die mit einer URL übereinstimmen und auf ein bestimmtes Feld beschränkt sind. |
|
| Hiermit werden Kontakte für eine URL abgerufen, die auf das angegebene benutzerdefinierte URL-Label beschränkt ist. |
Verworfene Methoden
createContact(givenName, familyName, email)
createContact(givenName, familyName, email)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Erstellt einen neuen Kontakt.
// The code below creates a new contact with the name "John Doe" and the email address // "john.doe@example.com". var contact = ContactsApp.createContact('John', 'Doe', 'john.doe@example.com');
Parameter
Name | Typ | Beschreibung |
---|---|---|
givenName | String | den Vornamen des Kontakts |
familyName | String | den Nachnamen des Kontakts |
email | String | die E-Mail-Adresse des Kontakts |
Return
: das neu erstellte KontaktobjektContact
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
createContactGroup(name)
createContactGroup(name)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Erstellt eine Kontaktgruppe mit dem angegebenen Namen
// The code below creates a new contact group named "Work Friends" var group = ContactsApp.createContactGroup("Work Friends");
Parameter
Name | Typ | Beschreibung |
---|---|---|
name | String | den Namen der neuen Kontaktgruppe |
Return
: die neu erstellte 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
deleteContact(contact)
deleteContact(contact)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Löscht den Kontakt.
// The code below retrieves a contact with the email address "john.doe@example.com" // and then deletes that contact. var contact = ContactsApp.getContact('john.doe@example.com'); ContactsApp.deleteContact(contact);
Parameter
Name | Typ | Beschreibung |
---|---|---|
contact |
| der zu löschende Kontakt |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
deleteContactGroup(group)
deleteContactGroup(group)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Die Kontaktgruppe wird gelöscht.
// The code below creates deletes the contact group named "Work Friends" var group = ContactsApp.getContactGroup("Work Friends"); ContactsApp.deleteContactGroup(group);
Parameter
Name | Typ | Beschreibung |
---|---|---|
group |
| die zu löschende 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
findByEmailAddress(email)
findByEmailAddress(email)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Kontakt mit der angegebenen E-Mail-Adresse suchen
Parameter
Name | Typ | Beschreibung |
---|---|---|
email | String | die E-Mail-Adresse des zu suchenden Kontakts |
Return
: der Kontakt mit dieser E-Mail-AdresseContact
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
findContactGroup(name)
findContactGroup(name)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Findet eine Kontaktgruppe mit dem angegebenen Namen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
name | String | den Namen der Kontaktgruppe, |
Return
: die Kontaktgruppe, die mit dem angegebenen Namen übereinstimmtContactGroup
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
getAllContacts()
getAllContacts()
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Ruft alle Kontakte ab, die zu diesem Nutzer gehören.
Return
– alle Kontakte für diesen NutzerContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
getContact(emailAddress)
getContact(emailAddress)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Ruft einen Kontakt über die E-Mail-Adresse ab.
Wenn mehrere Kontakte dieselbe E-Mail-Adresse haben, werden bei der Methode die Kontakte bevorzugt, die die E-Mail-Adresse als primär markiert haben. Wenn keiner der Kontakte die E-Mail-Adresse als primär markiert hat oder bei mehreren Kontakten die E-Mail-Adresse als primär markiert war, wird das erste Ergebnis in der sortierten Kontaktreihenfolge zurückgegeben.
// The code below retrieves a contact with the email address "john.doe@example.com". var contact = ContactsApp.getContact('john.doe@example.com');
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | die E-Mail-Adresse des Kontakts |
Return
: der Kontakt, der diese E-Mail-Adresse enthältContact
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactById(id)
getContactById(id)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Ruft den Kontakt mit dieser ID ab.
// The code below retrieves the contact with the id // "http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34ca5" var id = 'http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34c'; var contact = ContactApp.getContactById(id);
Parameter
Name | Typ | Beschreibung |
---|---|---|
id | String | Die ID des abzurufenden Kontakts |
Return
: der entsprechende Kontakt oder nullContact
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactGroup(name)
getContactGroup(name)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Ruft eine Kontaktgruppe mit dem angegebenen Namen ab oder gibt null zurück, wenn keine solche Kontaktgruppe gefunden wird.
// The code below returns the contact group with the name "Work Friends" var group = ContactsApp.getContactGroup('Work Friends');
Parameter
Name | Typ | Beschreibung |
---|---|---|
name | String | den Namen der entsprechenden Kontaktgruppe |
Return
: die übereinstimmende Kontaktgruppe oder null, wenn keine entsprechende Kontaktgruppe gefunden wirdContactGroup
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactGroupById(id)
getContactGroupById(id)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Ruft eine Kontaktgruppe mit der angegebenen ID ab oder gibt null zurück, wenn keine solche Kontaktgruppe gefunden wird.
// The code below returns the contact group with the id // "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb" var id = "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb"; var group = ContactsApp.getContactGroupById(id);
Parameter
Name | Typ | Beschreibung |
---|---|---|
id | String | ID der zu vergleichenden Kontaktgruppe |
Return
: die übereinstimmende Kontaktgruppe oder null, wenn keine entsprechende Kontaktgruppe gefunden wirdContactGroup
Weitere Informationen
getContactGroups()
getContactGroups()
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Ruft die vollständige Liste der Kontaktgruppen des Nutzers ab.
Ein Nutzer kann eine Liste mit Kontakten und möglicherweise auch eine Liste von Kontaktgruppen haben. Jede Kontaktgruppe kann Kontakte enthalten. Bei dieser Methode wird eine Liste aller Kontaktgruppen zurückgegeben.
// The retrieves all the contract groups for the user and then logs the group name of each // contact group. var groups = ContactsApp.getContactGroups(); for (var i = 0; i < groups.length; i++) { Logger.log(groups[i].getName()); }
Return
: Ein Array der Kontaktgruppen des NutzersContactGroup[]
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 des Nutzers ab.
// The code below will retrieve all the user's contacts var contacts = ContactsApp.getContacts();
Return
: ein Array aller Kontakte des NutzersContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByAddress(query)
getContactsByAddress(query)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Kontakte für eine Adresse abrufen.
// The code below returns an array of contacts where the contact's address contains // "San Francisco'. var contacts = ContactsApp.getContactsByAddress('San Francisco');
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | Die Zeichenfolge, nach der in den Adressen des Kontakts gesucht werden soll |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByAddress(query, label)
getContactsByAddress(query, label)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Hiermit können Sie Kontakte abrufen, die mit einer Adresse übereinstimmen und auf ein bestimmtes Feld beschränkt sind.
// The code below returns an array of contacts where the contact's address contains // "San Francisco" in the Home address field. var contacts = ContactsApp.getContactsByAddress('San Francisco', ContactsApp.Field.HOME_ADDRESS);
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | Die Zeichenfolge, nach der in den Adressen des Kontakts gesucht werden soll |
label |
| das Feld, in dem gesucht werden soll |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByAddress(query, label)
getContactsByAddress(query, label)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Hiermit werden Kontakte für eine Adresse abgerufen, die auf das angegebene benutzerdefinierte Adresslabel beschränkt ist.
// The code below returns an array of contacts where the contact's address contains // "San Francisco" in a custom address label (created by the user) called // "vacation". var contacts = ContactsApp.getContactsByAddress('San Francisco', 'vacation');
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | Die Zeichenfolge, nach der in den Adressen des Kontakts mit dem angegebenen benutzerdefinierten Adresslabel gesucht werden soll |
label | String | das benutzerdefinierte Adresslabel für die Suche |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByCompany(query)
getContactsByCompany(query)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Kontakte abrufen, die dem Unternehmensfeld entsprechen.
// The code below returns an array of contacts where the contact's company field // contains "Google". var contacts = ContactsApp.getContactsByCompany('Google');
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | Zeichenfolge, nach der im Unternehmensfeld des Kontakts gesucht werden soll |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByCustomField(query, label)
getContactsByCustomField(query, label)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Kontakte abrufen, die mit einem bestimmten Wert in einem benutzerdefinierten Feld übereinstimmen.
Das benutzerdefinierte Feld kann durch einen String oder als einen der Werte für ContactsApp.ExtendedField angegeben werden.
// The code below returns an array of contacts where the contact's custom field // named "Favorite Sport" contains "tennis". var contacts = ContactsApp.getContactsByCustomField('tennis', 'Favorite Sport');
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | Object | Zeichenfolge, nach der im benutzerdefinierten Feld des Kontakts gesucht werden soll |
label |
| das benutzerdefinierte Feld für die Suche |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByDate(month, day, label)
getContactsByDate(month, day, label)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Ruft Kontakte für ein bestimmtes Standardfeld mit einem bestimmten Monat und Tag ab.
// The code below returns an array of contacts where the contact's "Birthday" field // contains April for the month and 19 for the day. var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, ContactsApp.Field.BIRTHDAY);
Parameter
Name | Typ | Beschreibung |
---|---|---|
month | Month | den entsprechenden Monat als einen der Werte aus „ContactApp.Month“ |
day | Integer | der passende Tag |
label |
| das zu durchsuchende Feld (über „KontakteApp.Field“) |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByDate(month, day, year, label)
getContactsByDate(month, day, year, label)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Sie können Kontakte für ein bestimmtes Standardfeld nach Monat, Tag und Jahr abrufen.
// The code below returns an array of contacts where the contact's "Birthday" field // contains April for the month, 19 for the day, and 1950 for the year. var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 1950, ContactsApp.Field.BIRTHDAY);
Parameter
Name | Typ | Beschreibung |
---|---|---|
month | Month | den entsprechenden Monat als einen der Werte aus „ContactApp.Month“ |
day | Integer | der passende Tag |
year | Integer | das entsprechende Jahr, kann null sein |
label |
| das zu durchsuchende Feld (über „KontakteApp.Field“) |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByDate(month, day, year, label)
getContactsByDate(month, day, year, label)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Sie können Kontakte für ein bestimmtes benutzerdefiniertes Feld für einen bestimmten Monat, einen bestimmten Tag und ein bestimmtes Jahr abrufen.
// The code below returns an array of contacts where the contact's custom "Start Date" field // contains April for the month, 19 for the day, and 2011 for the year. var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 2011, 'Start Date');
Parameter
Name | Typ | Beschreibung |
---|---|---|
month | Month | den entsprechenden Monat als einen der Werte aus „ContactApp.Month“ |
day | Integer | der passende Tag |
year | Integer | das entsprechende Jahr, kann null sein |
label | String | das benutzerdefinierte Feld für die Suche |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByDate(month, day, label)
getContactsByDate(month, day, label)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Rufen Sie Kontakte für ein bestimmtes benutzerdefiniertes Feld für einen bestimmten Monat und Tag ab.
// The code below returns an array of contacts where the contact's custom "Start Date" field // contains April for the month and 19 for the day. var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 'Start Date');
Parameter
Name | Typ | Beschreibung |
---|---|---|
month | Month | den entsprechenden Monat als einen der Werte aus „ContactApp.Month“ |
day | Integer | der passende Tag |
label | String | das benutzerdefinierte Feld für die Suche |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByEmailAddress(query)
getContactsByEmailAddress(query)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Hiermit können Sie Kontakte abrufen, die mit einer E-Mail-Adresse übereinstimmen.
// The code below returns an array of contacts where the contact's email address contains // "john.doe@example.com'. var contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com');
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | Zeichenfolge, nach der in Kontakt-E-Mail-Adressen gesucht werden soll |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByEmailAddress(query, label)
getContactsByEmailAddress(query, label)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Hiermit können Sie Kontakte abrufen, die mit einer E-Mail-Adresse übereinstimmen und auf ein bestimmtes Feld beschränkt sind.
// The code below returns an array of contacts where the contact's email address contains // "john.doe@example.com" in the Home email field. var contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com', ContactsApp.Field.HOME_EMAIL);
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | Zeichenfolge, nach der in Kontakt-E-Mail-Adressen gesucht werden soll |
label |
| das Feld, in dem gesucht werden soll |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByEmailAddress(query, label)
getContactsByEmailAddress(query, label)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Hiermit werden Kontakte abgerufen, die mit einer E-Mail-Adresse übereinstimmen, die auf das angegebene Label der benutzerdefinierten E-Mail-Adresse beschränkt ist.
// The code below returns an array of contacts where the contact's email address contains // "john.doe@example.com" in a custom email address label (created by the user) called // "alternate". var contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com', 'alternate');
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | Die Zeichenfolge, nach der in Kontakt-E-Mail-Adressen mit dem angegebenen Label für benutzerdefinierte E-Mail-Adressen gesucht werden soll |
label | String | das benutzerdefinierte Label für die E-Mail-Adresse, in dem gesucht werden soll |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByGroup(group)
getContactsByGroup(group)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Ruft die Kontakte in einer bestimmten Kontaktgruppe ab.
// The code below returns an array of contacts in the ContactGroup with the name // "Work Friends". var group = ContactsApp.getContactGroup('Work Friends'); var contacts = ContactsApp.getContactsByGroup(group);
Parameter
Name | Typ | Beschreibung |
---|---|---|
group |
| die Gruppe von Kontakten |
Return
: ein Array der Kontakte in der angegebenen GruppeContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByIM(query)
getContactsByIM(query)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Hiermit können Sie Kontakte abrufen, die mit einer Instant-Messaging-Adresse übereinstimmen.
// The code below returns an array of contacts where the contact's instant messaging address // contains "ChatWithJohnDoe" in any instant messaging field. var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe');
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | Die Zeichenfolge, nach der in den Instant-Messaging-Adressen des Kontakts gesucht werden soll |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByIM(query, label)
getContactsByIM(query, label)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Hiermit können Sie Kontakte abrufen, die einer Instant-Messaging-Adresse entsprechen, die auf ein bestimmtes Feld beschränkt sind.
// The code below returns an array of contacts where the contact's instant messaging address // contains "ChatWithJohnDoe" in the AIM instant messaging field. var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', ContactsApp.Field.AIM);
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | Die Zeichenfolge, nach der in den Instant-Messaging-Adressen des Kontakts gesucht werden soll |
label |
| das Feld, in dem gesucht werden soll |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByIM(query, label)
getContactsByIM(query, label)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Hiermit werden Kontakte abgerufen, die einer Instant Messaging-Adresse entsprechen, die auf das angegebene benutzerdefinierte Instant Messaging-Label beschränkt ist.
// The code below returns an array of contacts where the contact's instant messaging address // contains "ChatWithJohnDoe" in a custom instant messaging label (created by the user) called // "eBuddy". var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', 'eBuddy');
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | Die Zeichenfolge, nach der in den Instant-Messaging-Adressen des Kontakts mit dem angegebenen benutzerdefinierten Instant-Messaging-Label gesucht werden soll |
label | String | das benutzerdefinierte Instant Messaging-Label für die Suche |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByJobTitle(query)
getContactsByJobTitle(query)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Kontakte abrufen, die mit dem Feld für die Stellenbezeichnung übereinstimmen.
// The code below returns an array of contacts where the contact's job title field // contains "Product Manager". var contacts = ContactsApp.getContactsByJobTitle('Product Manager');
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | Die Zeichenfolge, nach der im Feld für die Berufsbezeichnung des Kontakts gesucht werden soll |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByName(query)
getContactsByName(query)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Kontakte mit einem bestimmten Namen abrufen.
// The code below returns an array of contacts where the contact name contains "John" var contacts = ContactsApp.getContactsByName('John');
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | die Zeichenfolge, nach der in Kontaktnamen gesucht werden soll |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByName(query, label)
getContactsByName(query, label)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Hiermit können Sie Kontakte abrufen, die einem Namen entsprechen, beschränkt auf ein bestimmtes Feld.
// The code below returns an array of contacts where the contact name contains "John" // in the Given Name field. var contacts = ContactsApp.getContactsByName('John', ContactsApp.Field.GIVEN_NAME);
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | die Zeichenfolge, nach der in Kontaktnamen gesucht werden soll |
label |
| das Feld, in dem gesucht werden soll |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByNotes(query)
getContactsByNotes(query)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Kontakte für das Notizenfeld abrufen.
// The code below returns an array of contacts where the contact's notes field // contains "sent birthday card". var contacts = ContactsApp.getContactsByNotes('sent birthday card');
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | Die Zeichenfolge, nach der im Feld für die Notizen des Kontakts gesucht werden soll |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByPhone(query)
getContactsByPhone(query)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Sie können Kontakte abrufen, die mit einer Telefonnummer übereinstimmen.
Bei dieser Methode werden Telefonnummern mit Buchstaben erweitert. Wenn Sie also nach "212-555-CODE" suchen und "212-555-2633" in Ihren Kontakten haben oder umgekehrt, wird mit dieser Methode der entsprechende Kontakt gefunden.
// The code below returns an array of contacts where the contact's phone number contains // "212-555-1234' in any phone number field. var contacts = ContactsApp.getContactsByPhone('212-555-1234');
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | Zeichenfolge, nach der in den Telefonnummern des Kontakts gesucht werden soll |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByPhone(query, label)
getContactsByPhone(query, label)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Hiermit können Sie Kontakte abrufen, die mit einer Telefonnummer übereinstimmen, die auf ein bestimmtes Feld beschränkt ist.
Bei dieser Methode werden Telefonnummern mit Buchstaben erweitert. Wenn Sie also nach "212-555-CODE" suchen und "212-555-2633" in Ihren Kontakten haben oder umgekehrt, wird mit dieser Methode der entsprechende Kontakt gefunden.
// The code below returns an array of contacts where the contact's phone number contains // "212-555-1234" in the Home phone number field. var contacts = ContactsApp.getContactsByPhone('212-555-1234', ContactsApp.Field.HOME_PHONE);
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | Zeichenfolge, nach der in den Telefonnummern des Kontakts gesucht werden soll |
label |
| das Feld, in dem gesucht werden soll |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByPhone(query, label)
getContactsByPhone(query, label)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Hiermit werden Kontakte abgerufen, die mit einer Telefonnummer übereinstimmen, die auf das angegebene benutzerdefinierte Telefonnummernlabel beschränkt ist.
Bei dieser Methode werden Telefonnummern mit Buchstaben erweitert. Wenn Sie also nach "212-555-CODE" suchen und "212-555-2633" in Ihren Kontakten haben oder umgekehrt, wird mit dieser Methode der entsprechende Kontakt gefunden.
// The code below returns an array of contacts where the contact's phone number contains // "212-555-1234" in a custom phone number label (created by the user) called // "alternate". var contacts = ContactsApp.getContactsByPhone('212-555-1234', 'alternate');
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | Die Zeichenfolge, nach der in den Telefonnummern des Kontakts mit dem angegebenen benutzerdefinierten Telefonnummernlabel gesucht werden soll |
label | String | das benutzerdefinierte Telefonnummernlabel für die Suche |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByUrl(query)
getContactsByUrl(query)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Hiermit werden Kontakte für eine URL abgerufen.
// The code below returns an array of contacts where the contact's URL contains // "www.example.com' in any URL field. var contacts = ContactsApp.getContactsByUrl('www.example.com');
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | Zeichenfolge, nach der in den Kontakt-URLs gesucht werden soll |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByUrl(query, label)
getContactsByUrl(query, label)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Hiermit können Sie Kontakte abrufen, die mit einer URL übereinstimmen und auf ein bestimmtes Feld beschränkt sind.
// The code below returns an array of contacts where the contact's URL contains // "www.example.com" in the Work URL field. var contacts = ContactsApp.getContactsByUrl('www.example.com', ContactsApp.Field.WORK_WEBSITE);
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | Zeichenfolge, nach der in den Kontakt-URLs gesucht werden soll |
label |
| das Feld, in dem gesucht werden soll |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds
Weitere Informationen
getContactsByUrl(query, label)
getContactsByUrl(query, label)
Veraltet. Diese Funktion wurde eingestellt und sollte nicht in neuen Skripts verwendet werden.
Hiermit werden Kontakte für eine URL abgerufen, die auf das angegebene benutzerdefinierte URL-Label beschränkt ist.
// The code below returns an array of contacts where the contact's URL contains // "www.example.com" in a custom URL label (created by the user) called // "alternate work". var contacts = ContactsApp.getContactsByUrl('www.example.com', 'alternate work');
Parameter
Name | Typ | Beschreibung |
---|---|---|
query | String | Die Zeichenfolge, nach der in den Kontakt-URLs mit dem angegebenen benutzerdefinierten URL-Label gesucht werden soll |
label | String | das benutzerdefinierte URL-Label für die Suche |
Return
: ein Array übereinstimmender KontakteContact[]
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.google.com/m8/feeds