Veraltet. Verwenden Sie stattdessen die erweiterte People API-API Dienst
In diesem Kurs können Nutzer auf ihre eigenen Google-Kontakte zugreifen sowie Kontakte erstellen, entfernen und aktualisieren. Kontakte aufgeführt.
Verworfene Attribute
Attribut | 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 | Löscht die Kontaktgruppe |
|
| Findet einen Kontakt mit der angegebenen E-Mail-Adresse. |
|
| Findet eine Kontaktgruppe mit dem angegebenen Namen. |
|
| Ruft alle Kontakte dieses Nutzers ab. |
|
| Ruft einen Kontakt anhand der 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 abrufen, die mit einer Adresse übereinstimmen. |
|
| Hiermit werden Kontakte abgerufen, die mit einer Adresse übereinstimmen (auf ein bestimmtes Feld beschränkt). |
|
| Ruft Kontakte ab, die mit einer Adresse übereinstimmen, beschränkt auf das angegebene benutzerdefinierte Adresslabel. |
|
| Mit dem Unternehmensfeld übereinstimmende Kontakte abrufen. |
|
| Kontakte abrufen, die mit einem bestimmten Wert in einem benutzerdefinierten Feld übereinstimmen. |
|
| Rufen Sie Kontakte ab, die einem bestimmten Monat und einem bestimmten Tag für ein bestimmtes Standardfeld entsprechen. |
|
| Hiermit können Sie Kontakte abrufen, die einem bestimmten Monat, Tag und Jahr für ein bestimmtes Standardfeld entsprechen. |
|
| Rufen Sie Kontakte ab, die einem bestimmten Monat, Tag und Jahr für ein bestimmtes benutzerdefiniertes Feld entsprechen. |
|
| Rufen Sie Kontakte ab, die einem bestimmten Monat und einem bestimmten Tag für ein bestimmtes benutzerdefiniertes Feld entsprechen. |
|
| Rufen Sie Kontakte ab, die mit einer E-Mail-Adresse übereinstimmen. |
|
| Hiermit können Sie Kontakte abrufen, die mit einer E-Mail-Adresse übereinstimmen (auf ein bestimmtes Feld beschränkt). |
|
| Hiermit werden Kontakte abgerufen, die mit einer E-Mail-Adresse übereinstimmen. Dies ist auf das angegebene Label für eine benutzerdefinierte E-Mail-Adresse beschränkt. |
|
| Ruft die Kontakte in einer bestimmten ContactGroup ab. |
|
| Rufen Sie Kontakte ab, die einer Instant Messaging-Adresse entsprechen. |
|
| Hiermit können Sie Kontakte abrufen, die mit einer Instant Messaging-Adresse übereinstimmen (auf ein bestimmtes Feld beschränkt). |
|
| Kontakte abrufen, die einer Instant Messaging-Adresse entsprechen, beschränkt auf die angegebene benutzerdefinierte Instant-Version Nachrichtenlabel. |
|
| Rufen Sie Kontakte ab, die dem Feld für die Stellenbezeichnung entsprechen. |
|
| Kontakte abrufen, die mit einem Namen übereinstimmen. |
|
| Kontakte abrufen, die mit einem Namen übereinstimmen, beschränkt auf ein bestimmtes Feld. |
|
| Kontakte abrufen, die mit dem Notizfeld übereinstimmen. |
|
| Rufen Sie Kontakte ab, die einer Telefonnummer entsprechen. |
|
| Sie können Kontakte abrufen, die mit einer Telefonnummer übereinstimmen (auf ein bestimmtes Feld beschränkt). |
|
| Hiermit werden Kontakte abgerufen, die mit einer Telefonnummer übereinstimmen, begrenzt auf das angegebene benutzerdefinierte Telefonnummernlabel. |
|
| Kontakte abrufen, die mit einer URL übereinstimmen. |
|
| Kontakte abrufen, die mit einer URL übereinstimmen, beschränkt auf ein bestimmtes Feld. |
|
| Hiermit werden Kontakte abgerufen, die mit einer URL übereinstimmen, begrenzt auf das angegebene benutzerdefinierte URL-Label. |
Verworfene Methoden
createContact(givenName, familyName, email)
createContact(givenName, familyName, email)
Veraltet. Diese Funktion ist veraltet 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 | Vorname des Kontakts |
familyName | String | Nachname des Kontakts |
email | String | die E-Mail-Adresse des Kontakts |
Rückflug
: 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 ist veraltet 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 |
Rückflug
: 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 ist veraltet 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 |
| den zu löschenden 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Löscht die Kontaktgruppe
// 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Findet einen Kontakt mit der angegebenen E-Mail-Adresse.
Parameter
Name | Typ | Beschreibung |
---|---|---|
email | String | die E-Mail-Adresse des Kontakts, der gefunden werden soll |
Rückflug
: 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
findContactGroup(name)
findContactGroup(name)
Veraltet. Diese Funktion ist veraltet 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, |
Rückflug
: Die Kontaktgruppe, die dem angegebenen Namen entsprichtContactGroup
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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Ruft alle Kontakte dieses Nutzers ab.
Rückflug
: alle Kontakte dieses NutzersContact[]
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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Ruft einen Kontakt anhand der E-Mail-Adresse ab.
Wenn mehrere Kontakte dieselbe E-Mail-Adresse haben, bevorzugt die Methode diejenigen Kontakte, die E-Mail-Adresse als primäre E-Mail-Adresse markiert haben, wenn keiner der Kontakte die E-Mail-Adresse die E-Mail-Adresse des primären Kontakts oder mehrerer Kontakte als "primär" markiert wurde, in der Reihenfolge der sortierten Kontakte.
// 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 |
Rückflug
– 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 ist veraltet 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. |
Rückflug
: der übereinstimmende 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 ist veraltet 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 | Name der Kontaktgruppe, die abgeglichen werden soll |
Rückflug
: 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 ist veraltet 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 | Die ID der abzugleichenden Kontaktgruppe |
Rückflug
: die übereinstimmende Kontaktgruppe oder null, wenn keine entsprechende Kontaktgruppe gefunden wirdContactGroup
Weitere Informationen
getContactGroups()
getContactGroups()
Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Ruft die vollständige Liste der Kontaktgruppen des Nutzers ab.
Ein Nutzer kann eine Liste von Kontakten und möglicherweise auch eine Liste von Kontaktgruppen haben. Jedes Kontaktgruppe kann Kontakte enthalten. Diese Methode gibt eine Liste aller Kontaktgruppen zurück.
// 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()); }
Rückflug
: 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 ist veraltet 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();
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Kontakte abrufen, die mit einer Adresse übereinstimmen.
// 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 | Zeichenfolge, nach der in Kontaktadressen gesucht werden soll |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Hiermit werden Kontakte abgerufen, die mit einer Adresse übereinstimmen (auf ein bestimmtes Feld beschränkt).
// 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 | Zeichenfolge, nach der in Kontaktadressen gesucht werden soll |
label |
| das Feld für die Suche |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Ruft Kontakte ab, die mit einer Adresse übereinstimmen, beschränkt auf das angegebene benutzerdefinierte Adresslabel.
// 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 der angegebenen benutzerdefinierten Adresse gesucht werden soll Label |
label | String | Das benutzerdefinierte Adresslabel für die Suche |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Mit dem Unternehmensfeld übereinstimmende Kontakte abrufen.
// 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 |
Rückflug
: 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 ist veraltet 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 eines der KontakteApp.ExtendedField-Felder angegeben werden. Werte.
// 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 | Die Zeichenfolge, nach der im benutzerdefinierten Feld des Kontakts gesucht werden soll |
label |
| das benutzerdefinierte Feld für die Suche |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Rufen Sie Kontakte ab, die einem bestimmten Monat und einem bestimmten Tag für ein bestimmtes Standardfeld entsprechen.
// 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 abzugleichenden Monat als Wert aus ContactsApp.Month |
day | Integer | den passenden Tag |
label |
| das Feld, in dem gesucht werden soll, aus „ContactsApp.Field“ |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Hiermit können Sie Kontakte abrufen, die einem bestimmten Monat, Tag und Jahr für ein bestimmtes Standardfeld entsprechen.
// 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 abzugleichenden Monat als Wert aus ContactsApp.Month |
day | Integer | den passenden Tag |
year | Integer | das Jahr für den Abgleich, kann null sein |
label |
| das Feld, in dem gesucht werden soll, aus „ContactsApp.Field“ |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Rufen Sie Kontakte ab, die einem bestimmten Monat, Tag und Jahr für ein bestimmtes benutzerdefiniertes Feld entsprechen.
// 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 abzugleichenden Monat als Wert aus ContactsApp.Month |
day | Integer | den passenden Tag |
year | Integer | das Jahr für den Abgleich, kann null sein |
label | String | das benutzerdefinierte Feld für die Suche |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Rufen Sie Kontakte ab, die einem bestimmten Monat und einem bestimmten Tag für ein bestimmtes benutzerdefiniertes Feld entsprechen.
// 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 abzugleichenden Monat als Wert aus ContactsApp.Month |
day | Integer | den passenden Tag |
label | String | das benutzerdefinierte Feld für die Suche |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Rufen Sie Kontakte ab, 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 |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Hiermit können Sie Kontakte abrufen, die mit einer E-Mail-Adresse übereinstimmen (auf ein bestimmtes Feld beschränkt).
// 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 für die Suche |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Hiermit werden Kontakte abgerufen, die mit einer E-Mail-Adresse übereinstimmen. Dies ist auf das angegebene Label für eine benutzerdefinierte E-Mail-Adresse beschränkt.
// 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 benutzerdefinierten Label für E-Mail-Adresse |
label | String | Das benutzerdefinierte Label für E-Mail-Adressen, in dem gesucht werden soll |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Ruft die Kontakte in einer bestimmten ContactGroup 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 der Kontakte |
Rückflug
: ein Array von Kontakten 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Rufen Sie Kontakte ab, die einer Instant Messaging-Adresse entsprechen.
// 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 |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Hiermit können Sie Kontakte abrufen, die mit einer Instant Messaging-Adresse übereinstimmen (auf ein bestimmtes Feld beschränkt).
// 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 für die Suche |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Kontakte abrufen, die einer Instant Messaging-Adresse entsprechen, beschränkt auf die angegebene benutzerdefinierte Instant-Version Nachrichtenlabel.
// 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 | Entspricht der Zeichenfolge, nach der in den Instant-Messaging-Adressen des Kontakts mit der Methode Angegebenes benutzerdefiniertes Label für Instant Messaging |
label | String | Das benutzerdefinierte Label für Instant Messaging zur Suche in |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Rufen Sie Kontakte ab, die dem Feld für die Stellenbezeichnung entsprechen.
// 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 Stellenbezeichnung des Kontakts gesucht werden soll |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Kontakte abrufen, die mit einem Namen übereinstimmen.
// 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 | Zeichenfolge, nach der in den Kontaktnamen gesucht werden soll |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Kontakte abrufen, die mit einem Namen übereinstimmen, 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 | Zeichenfolge, nach der in den Kontaktnamen gesucht werden soll |
label |
| das Feld für die Suche |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Kontakte abrufen, die mit dem Notizfeld übereinstimmen.
// 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 | Zeichenfolge, nach der im Notizenfeld des Kontakts gesucht werden soll |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Rufen Sie Kontakte ab, die einer Telefonnummer entsprechen.
Bei dieser Methode werden Telefonnummern mit Buchstaben erweitert, also wenn Sie nach "212-555-CODE" suchen. und Sie haben '212-555-2633' oder umgekehrt, sucht die Methode die passenden Kontakt.
// 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 |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Sie können Kontakte abrufen, die einer Telefonnummer entsprechen (auf ein bestimmtes Feld beschränkt).
Bei dieser Methode werden Telefonnummern mit Buchstaben erweitert, also wenn Sie nach "212-555-CODE" suchen. und Sie haben '212-555-2633' oder umgekehrt, sucht die Methode die passenden Kontakt.
// 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 für die Suche |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Hiermit werden Kontakte abgerufen, die mit einer Telefonnummer übereinstimmen, begrenzt auf das angegebene benutzerdefinierte Telefonnummernlabel.
Bei dieser Methode werden Telefonnummern mit Buchstaben erweitert, also wenn Sie nach "212-555-CODE" suchen. und Sie haben '212-555-2633' oder umgekehrt, sucht die Methode die passenden Kontakt.
// 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 Label für Telefonnummer |
label | String | Das benutzerdefinierte Telefonnummernlabel für die Suche |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Kontakte abrufen, die mit einer URL übereinstimmen.
// 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 | die Zeichenfolge, nach der in den URLs des Kontakts gesucht werden soll |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Kontakte abrufen, die mit einer URL übereinstimmen, beschränkt auf ein bestimmtes Feld.
// 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 | die Zeichenfolge, nach der in den URLs des Kontakts gesucht werden soll |
label |
| das Feld für die Suche |
Rückflug
: 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 ist veraltet und sollte nicht in neuen Skripts verwendet werden.
Hiermit werden Kontakte abgerufen, die mit einer URL übereinstimmen, begrenzt auf das angegebene benutzerdefinierte URL-Label.
// 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 | Zeichenfolge, nach der in den URLs des Kontakts mit dem angegebenen benutzerdefinierten URL-Label gesucht werden soll |
label | String | Das benutzerdefinierte URL-Label für die Suche |
Rückflug
: 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