Diese Seite wurde von der Cloud Translation API übersetzt.

Class ContactsApp

Veraltet. Verwenden Sie stattdessen den erweiterten Dienst der People API.

Mit dieser Klasse können Nutzer auf ihre eigenen Google-Kontakte zugreifen und darin aufgeführte Kontakte erstellen, entfernen und aktualisieren.

Eingestellte Properties

Attribut	Typ	Beschreibung
`ExtendedField`	`ExtendedField`
`Field`	`Field`
`Gender`	`Gender`
`Month`	`Month`
`Priority`	`Priority`
`Sensitivity`	`Sensitivity`

Eingestellte Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`createContact(givenName, familyName, email)`	`Contact`	Erstellt einen neuen Kontakt.
`createContactGroup(name)`	`ContactGroup`	Erstellt eine Kontaktgruppe mit dem angegebenen Namen // The code below creates a new contact group named "Work Friends" const group = ContactsApp.createContactGroup('Work Friends');
`deleteContact(contact)`	`void`	Der Kontakt wird gelöscht.
`deleteContactGroup(group)`	`void`	Die Kontaktgruppe wird gelöscht. // The code below creates deletes the contact group named "Work Friends" const group = ContactsApp.getContactGroup('Work Friends'); ContactsApp.deleteContactGroup(group);
`findByEmailAddress(email)`	`Contact`	Sucht einen Kontakt mit der angegebenen E-Mail-Adresse.
`findContactGroup(name)`	`ContactGroup`	Sucht eine Kontaktgruppe mit dem angegebenen Namen.
`getAllContacts()`	`Contact[]`	Alle Kontakte abrufen, die zu diesem Nutzer gehören
`getContact(emailAddress)`	`Contact`	Ruft einen Kontakt anhand der E-Mail-Adresse ab.
`getContactById(id)`	`Contact`	Ruft den Kontakt mit dieser ID ab.
`getContactGroup(name)`	`ContactGroup`	Ruft eine Kontaktgruppe mit dem angegebenen Namen ab oder gibt „null“ zurück, wenn keine solche Kontaktgruppe gefunden wird.
`getContactGroupById(id)`	`ContactGroup`	Ruft eine Kontaktgruppe mit der angegebenen ID ab oder gibt „null“ zurück, wenn keine solche Kontaktgruppe gefunden wird.
`getContactGroups()`	`ContactGroup[]`	Ruft die vollständige Liste der Kontaktgruppen des Nutzers ab.
`getContacts()`	`Contact[]`	Ruft alle Kontakte des Nutzers ab.
`getContactsByAddress(query)`	`Contact[]`	Kontakte abrufen, die mit einer Adresse übereinstimmen
`getContactsByAddress(query, label)`	`Contact[]`	Kontakte abrufen, die mit einer Adresse übereinstimmen, beschränkt auf ein bestimmtes Feld.
`getContactsByAddress(query, label)`	`Contact[]`	Kontakte abrufen, die mit einer Adresse übereinstimmen, beschränkt auf das angegebene benutzerdefinierte Adresslabel.
`getContactsByCompany(query)`	`Contact[]`	Kontakte abrufen, die mit dem Feld „Unternehmen“ übereinstimmen
`getContactsByCustomField(query, label)`	`Contact[]`	Kontakte abrufen, die mit einem bestimmten Wert in einem benutzerdefinierten Feld übereinstimmen
`getContactsByDate(month, day, label)`	`Contact[]`	Kontakte abrufen, die für ein bestimmtes Standardfeld mit einem bestimmten Monat und Tag übereinstimmen
`getContactsByDate(month, day, year, label)`	`Contact[]`	Kontakte abrufen, die für ein bestimmtes Standardfeld mit einem bestimmten Monat, Tag und Jahr übereinstimmen
`getContactsByDate(month, day, year, label)`	`Contact[]`	Kontakte abrufen, die für ein bestimmtes benutzerdefiniertes Feld mit einem bestimmten Monat, Tag und Jahr übereinstimmen
`getContactsByDate(month, day, label)`	`Contact[]`	Kontakte abrufen, die für ein bestimmtes benutzerdefiniertes Feld mit einem bestimmten Monat und Tag übereinstimmen
`getContactsByEmailAddress(query)`	`Contact[]`	Kontakte abrufen, die mit einer E-Mail-Adresse übereinstimmen
`getContactsByEmailAddress(query, label)`	`Contact[]`	Kontakte abrufen, die mit einer E-Mail-Adresse übereinstimmen, beschränkt auf ein bestimmtes Feld.
`getContactsByEmailAddress(query, label)`	`Contact[]`	Kontakte abrufen, die mit einer E-Mail-Adresse übereinstimmen, beschränkt auf das angegebene Label für benutzerdefinierte E-Mail-Adressen.
`getContactsByGroup(group)`	`Contact[]`	Ruft die Kontakte in einer bestimmten Kontaktgruppe ab.
`getContactsByIM(query)`	`Contact[]`	Kontakte abrufen, die mit einer Instant-Messaging-Adresse übereinstimmen
`getContactsByIM(query, label)`	`Contact[]`	Kontakte abrufen, die mit einer Adresse für Instant Messaging übereinstimmen, beschränkt auf ein bestimmtes Feld
`getContactsByIM(query, label)`	`Contact[]`	Kontakte abrufen, die mit einer Adresse für Instant Messaging übereinstimmen, beschränkt auf das angegebene benutzerdefinierte Label für Instant Messaging.
`getContactsByJobTitle(query)`	`Contact[]`	Kontakte abrufen, die dem Feld „Position“ entsprechen
`getContactsByName(query)`	`Contact[]`	Kontakte abrufen, die mit einem Namen übereinstimmen
`getContactsByName(query, label)`	`Contact[]`	Kontakte abrufen, die mit einem Namen übereinstimmen, beschränkt auf ein bestimmtes Feld.
`getContactsByNotes(query)`	`Contact[]`	Kontakte abrufen, die mit dem Notizenfeld übereinstimmen
`getContactsByPhone(query)`	`Contact[]`	Kontakte abrufen, die mit einer Telefonnummer übereinstimmen
`getContactsByPhone(query, label)`	`Contact[]`	Kontakte abrufen, die mit einer Telefonnummer übereinstimmen, beschränkt auf ein bestimmtes Feld.
`getContactsByPhone(query, label)`	`Contact[]`	Kontakte abrufen, die mit einer Telefonnummer übereinstimmen, beschränkt auf das angegebene benutzerdefinierte Label für Telefonnummern.
`getContactsByUrl(query)`	`Contact[]`	Kontakte abrufen, die mit einer URL übereinstimmen
`getContactsByUrl(query, label)`	`Contact[]`	Kontakte abrufen, die mit einer URL übereinstimmen, beschränkt auf ein bestimmtes Feld
`getContactsByUrl(query, label)`	`Contact[]`	Kontakte abrufen, die mit einer URL übereinstimmen, beschränkt auf das angegebene Label für benutzerdefinierte URLs.

Eingestellte Methoden

`createContact(givenName, familyName, email)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht 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".
const 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

Rückflug

Contact: das neu erstellte Kontaktobjekt

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

deleteContact(contact)

`createContactGroup(name)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Erstellt eine Kontaktgruppe mit dem angegebenen Namen.

// The code below creates a new contact group named "Work Friends"
const group = ContactsApp.createContactGroup('Work Friends');

Parameter

Name	Typ	Beschreibung
`name`	`String`	den Namen der neuen Kontaktgruppe

Rückflug

ContactGroup – die neu erstellte Kontaktgruppe

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

deleteContactGroup(group)

`deleteContact(contact)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Der Kontakt wird gelöscht.

// The code below retrieves a contact with the email address
// "john.doe@example.com" and then deletes that contact.
const contact = ContactsApp.getContact('john.doe@example.com');
ContactsApp.deleteContact(contact);

Parameter

Name	Typ	Beschreibung
`contact`	`Contact`	den zu löschenden Kontakt

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

createContact(givenName, familyName, email)

`deleteContactGroup(group)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Die Kontaktgruppe wird gelöscht.

// The code below creates deletes the contact group named "Work Friends"
const group = ContactsApp.getContactGroup('Work Friends');
ContactsApp.deleteContactGroup(group);

Parameter

Name	Typ	Beschreibung
`group`	`ContactGroup`	die zu löschende Kontaktgruppe

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

createContactGroup(name)

`findByEmailAddress(email)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Sucht einen Kontakt mit der angegebenen E-Mail-Adresse.

Parameter

Name	Typ	Beschreibung
`email`	`String`	die E-Mail-Adresse des zu findenden Kontakts

Rückflug

Contact: Der Kontakt mit dieser E-Mail-Adresse

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`findContactGroup(name)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Sucht eine Kontaktgruppe mit dem angegebenen Namen.

Parameter

Name	Typ	Beschreibung
`name`	`String`	der Name der zu suchenden Kontaktgruppe

Rückflug

ContactGroup: die Kontaktgruppe, die mit dem angegebenen Namen übereinstimmt

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getAllContacts()`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Alle Kontakte abrufen, die zu diesem Nutzer gehören

Rückflug

Contact[] – alle Kontakte für diesen Nutzer

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getContact(emailAddress)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Ruft einen Kontakt anhand der E-Mail-Adresse ab.

Wenn mehrere Kontakte dieselbe E-Mail-Adresse haben, werden 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 mehrere Kontakte die E-Mail-Adresse als primär markiert haben, wird das erste Ergebnis in der sortierten Kontaktreihenfolge zurückgegeben.

// The code below retrieves a contact with the email address
// "john.doe@example.com".
const contact = ContactsApp.getContact('john.doe@example.com');

Parameter

Name	Typ	Beschreibung
`emailAddress`	`String`	die E-Mail-Adresse des Kontakts

Rückflug

Contact – der Kontakt mit dieser E-Mail-Adresse

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getContactById(id)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht 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"
const id =
    'http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34c';
const contact = ContactsApp.getContactById(id);

Parameter

Name	Typ	Beschreibung
`id`	`String`	die ID des abzurufenden Kontakts

Rückflug

Contact – der übereinstimmende Kontakt oder „null“

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactGroup(name)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht 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"
const group = ContactsApp.getContactGroup('Work Friends');

Parameter

Name	Typ	Beschreibung
`name`	`String`	Der Name der Kontaktgruppe, die abgeglichen werden soll

Rückflug

ContactGroup: Die übereinstimmende Kontaktgruppe oder „null“, wenn keine übereinstimmende Kontaktgruppe gefunden wird.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContactGroups()

`getContactGroupById(id)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht 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"
const id =
    'http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb';
const group = ContactsApp.getContactGroupById(id);

Parameter

Name	Typ	Beschreibung
`id`	`String`	die ID der Kontaktgruppe, die abgeglichen werden soll

Rückflug

ContactGroup: Die übereinstimmende Kontaktgruppe oder „null“, wenn keine übereinstimmende Kontaktgruppe gefunden wird

Weitere Informationen

getContactGroups()

`getContactGroups()`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht 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 mit Kontaktgruppen haben. Jede 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.
const groups = ContactsApp.getContactGroups();
for (let i = 0; i < groups.length; i++) {
  Logger.log(groups[i].getName());
}

Rückflug

ContactGroup[]: ein Array der Kontaktgruppen des Nutzers

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContactGroup(name)

`getContacts()`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Ruft alle Kontakte des Nutzers ab.

// The code below will retrieve all the user's contacts
const contacts = ContactsApp.getContacts();

Rückflug

Contact[]: ein Array mit allen Kontakten des Nutzers

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByAddress(query)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht 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'.
const contacts = ContactsApp.getContactsByAddress('San Francisco');

Parameter

Name	Typ	Beschreibung
`query`	`String`	Der String, nach dem in den Adressen des Kontakts gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByAddress(query, label)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Kontakte abrufen, die mit einer Adresse übereinstimmen, beschränkt auf ein bestimmtes Feld.

// The code below returns an array of contacts where the contact's address
// contains "San Francisco" in the Home address field.
const contacts = ContactsApp.getContactsByAddress(
    'San Francisco',
    ContactsApp.Field.HOME_ADDRESS,
);

Parameter

Name	Typ	Beschreibung
`query`	`String`	Der String, nach dem in den Adressen des Kontakts gesucht werden soll
`label`	`Field`	das Feld, in dem gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByAddress(query, label)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Kontakte abrufen, 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".
const contacts = ContactsApp.getContactsByAddress('San Francisco', 'vacation');

Parameter

Name	Typ	Beschreibung
`query`	`String`	Der String, nach dem in den Adressen der Kontakte mit dem angegebenen benutzerdefinierten Adresslabel gesucht werden soll.
`label`	`String`	das benutzerdefinierte Adresslabel, in dem gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByCompany(query)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Kontakte abrufen, die mit dem Feld „Unternehmen“ übereinstimmen

// The code below returns an array of contacts where the contact's company field
// contains "Google".
const contacts = ContactsApp.getContactsByCompany('Google');

Parameter

Name	Typ	Beschreibung
`query`	`String`	Der String, nach dem im Feld „Unternehmen“ des Kontakts gesucht werden soll.

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByCustomField(query, label)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Kontakte abrufen, die mit einem bestimmten Wert in einem benutzerdefinierten Feld übereinstimmen

Das benutzerdefinierte Feld kann durch einen String oder als einer der Werte von ContactsApp.ExtendedField angegeben werden.

// The code below returns an array of contacts where the contact's custom field
// named "Favorite Sport" contains "tennis".
const contacts = ContactsApp.getContactsByCustomField(
    'tennis',
    'Favorite Sport',
);

Parameter

Name	Typ	Beschreibung
`query`	`Object`	Der String, nach dem im benutzerdefinierten Feld des Kontakts gesucht werden soll.
`label`	`ExtendedField`	das benutzerdefinierte Feld, in dem gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByDate(month, day, label)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Kontakte abrufen, die für ein bestimmtes Standardfeld mit einem bestimmten Monat und Tag übereinstimmen

// The code below returns an array of contacts where the contact's "Birthday"
// field contains April for the month and 19 for the day.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    ContactsApp.Field.BIRTHDAY,
);

Parameter

Name	Typ	Beschreibung
`month`	`Month`	Der zu vergleichende Monat, einer der Werte aus ContactsApp.Month
`day`	`Integer`	der Tag, der übereinstimmen soll
`label`	`Field`	das Feld, in dem gesucht werden soll, von ContactsApp.Field

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByDate(month, day, year, label)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Kontakte abrufen, die für ein bestimmtes Standardfeld mit einem bestimmten Monat, Tag und Jahr übereinstimmen

// 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.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    1950,
    ContactsApp.Field.BIRTHDAY,
);

Parameter

Name	Typ	Beschreibung
`month`	`Month`	Der zu vergleichende Monat, einer der Werte aus ContactsApp.Month
`day`	`Integer`	der Tag, der übereinstimmen soll
`year`	`Integer`	Das Jahr, das abgeglichen werden soll. Kann null sein.
`label`	`Field`	das Feld, in dem gesucht werden soll, von ContactsApp.Field

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByDate(month, day, year, label)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Kontakte abrufen, die für ein bestimmtes benutzerdefiniertes Feld mit einem bestimmten Monat, Tag und Jahr übereinstimmen

// 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.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    2011,
    'Start Date',
);

Parameter

Name	Typ	Beschreibung
`month`	`Month`	Der zu vergleichende Monat, einer der Werte aus ContactsApp.Month
`day`	`Integer`	der Tag, der übereinstimmen soll
`year`	`Integer`	Das Jahr, das abgeglichen werden soll. Kann null sein.
`label`	`String`	das benutzerdefinierte Feld, in dem gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByDate(month, day, label)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Kontakte abrufen, die für ein bestimmtes benutzerdefiniertes Feld mit einem bestimmten Monat und Tag übereinstimmen

// 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.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    'Start Date',
);

Parameter

Name	Typ	Beschreibung
`month`	`Month`	Der zu vergleichende Monat, einer der Werte aus ContactsApp.Month
`day`	`Integer`	der Tag, der übereinstimmen soll
`label`	`String`	das benutzerdefinierte Feld, in dem gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByEmailAddress(query)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

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'.
const contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com');

Parameter

Name	Typ	Beschreibung
`query`	`String`	Der String, nach dem in den E-Mail-Adressen der Kontakte gesucht werden soll.

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByEmailAddress(query, label)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Kontakte abrufen, die mit einer E-Mail-Adresse übereinstimmen, beschränkt auf ein bestimmtes Feld.

// The code below returns an array of contacts where the contact's email address
// contains "john.doe@example.com" in the Home email field.
const contacts = ContactsApp.getContactsByEmailAddress(
    'john.doe@example.com',
    ContactsApp.Field.HOME_EMAIL,
);

Parameter

Name	Typ	Beschreibung
`query`	`String`	Der String, nach dem in den E-Mail-Adressen der Kontakte gesucht werden soll.
`label`	`Field`	das Feld, in dem gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByEmailAddress(query, label)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Kontakte abrufen, die mit einer E-Mail-Adresse übereinstimmen, beschränkt auf das angegebene Label für benutzerdefinierte E-Mail-Adressen.

// 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".
const contacts = ContactsApp.getContactsByEmailAddress(
    'john.doe@example.com',
    'alternate',
);

Parameter

Name	Typ	Beschreibung
`query`	`String`	Der String, nach dem in den E-Mail-Adressen von Kontakten mit dem angegebenen benutzerdefinierten E-Mail-Adressenlabel gesucht werden soll
`label`	`String`	das Label für die benutzerdefinierte E-Mail-Adresse, in dem gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByGroup(group)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht 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".
const group = ContactsApp.getContactGroup('Work Friends');
const contacts = ContactsApp.getContactsByGroup(group);

Parameter

Name	Typ	Beschreibung
`group`	`ContactGroup`	der Kontaktgruppe

Rückflug

Contact[] – ein Array von Kontakten in der angegebenen Gruppe

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByIM(query)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

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.
const contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe');

Parameter

Name	Typ	Beschreibung
`query`	`String`	Der String, nach dem in den Messaging-Adressen des Kontakts gesucht werden soll.

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByIM(query, label)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Kontakte abrufen, die mit einer Adresse für Instant Messaging übereinstimmen, beschränkt auf ein bestimmtes Feld

// The code below returns an array of contacts where the contact's instant
// messaging address contains "ChatWithJohnDoe" in the AIM instant messaging
// field.
const contacts = ContactsApp.getContactsByIM(
    'ChatWithJohnDoe',
    ContactsApp.Field.AIM,
);

Parameter

Name	Typ	Beschreibung
`query`	`String`	Der String, nach dem in den Messaging-Adressen des Kontakts gesucht werden soll.
`label`	`Field`	das Feld, in dem gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByIM(query, label)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Kontakte abrufen, die mit einer Adresse für Instant Messaging übereinstimmen, beschränkt auf das angegebene benutzerdefinierte Label für Instant Messaging.

// 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".
const contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', 'eBuddy');

Parameter

Name	Typ	Beschreibung
`query`	`String`	Der String, nach dem in den Instant-Messaging-Adressen des Kontakts mit dem angegebenen benutzerdefinierten Instant-Messaging-Label gesucht werden soll
`label`	`String`	das benutzerdefinierte Label für Instant Messaging, in dem gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByJobTitle(query)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Kontakte abrufen, die dem Feld „Position“ entsprechen

// The code below returns an array of contacts where the contact's job title
// field contains "Product Manager".
const contacts = ContactsApp.getContactsByJobTitle('Product Manager');

Parameter

Name	Typ	Beschreibung
`query`	`String`	Der String, nach dem im Feld „Position“ des Kontakts gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByName(query)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Kontakte abrufen, die mit einem Namen übereinstimmen

// The code below returns an array of contacts where the contact name contains
// "John"
const contacts = ContactsApp.getContactsByName('John');

Parameter

Name	Typ	Beschreibung
`query`	`String`	der String, nach dem in Kontaktnamen gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByName(query, label)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht 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.
const contacts = ContactsApp.getContactsByName(
    'John',
    ContactsApp.Field.GIVEN_NAME,
);

Parameter

Name	Typ	Beschreibung
`query`	`String`	der String, nach dem in Kontaktnamen gesucht werden soll
`label`	`Field`	das Feld, in dem gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByNotes(query)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Kontakte abrufen, die mit dem Notizenfeld übereinstimmen

// The code below returns an array of contacts where the contact's notes field
// contains "sent birthday card".
const contacts = ContactsApp.getContactsByNotes('sent birthday card');

Parameter

Name	Typ	Beschreibung
`query`	`String`	Der String, nach dem im Notizenfeld des Kontakts gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByPhone(query)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

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 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.
const contacts = ContactsApp.getContactsByPhone('212-555-1234');

Parameter

Name	Typ	Beschreibung
`query`	`String`	Der String, nach dem in den Telefonnummern des Kontakts gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByPhone(query, label)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Kontakte abrufen, die mit einer Telefonnummer übereinstimmen, beschränkt auf ein bestimmtes Feld.

// The code below returns an array of contacts where the contact's phone number
// contains "212-555-1234" in the Home phone number field.
const contacts = ContactsApp.getContactsByPhone(
    '212-555-1234',
    ContactsApp.Field.HOME_PHONE,
);

Parameter

Name	Typ	Beschreibung
`query`	`String`	Der String, nach dem in den Telefonnummern des Kontakts gesucht werden soll
`label`	`Field`	das Feld, in dem gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByPhone(query, label)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Kontakte abrufen, die mit einer Telefonnummer übereinstimmen, beschränkt auf das angegebene benutzerdefinierte Label für Telefonnummern.

// 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".
const contacts = ContactsApp.getContactsByPhone('212-555-1234', 'alternate');

Parameter

Name	Typ	Beschreibung
`query`	`String`	Der String, nach dem in den Telefonnummern des Kontakts mit dem angegebenen benutzerdefinierten Label für Telefonnummern gesucht werden soll
`label`	`String`	das benutzerdefinierte Label für Telefonnummern, in dem gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByUrl(query)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht 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.
const contacts = ContactsApp.getContactsByUrl('www.example.com');

Parameter

Name	Typ	Beschreibung
`query`	`String`	Der String, nach dem in den URLs des Kontakts gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByUrl(query, label)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht 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.
const contacts = ContactsApp.getContactsByUrl(
    'www.example.com',
    ContactsApp.Field.WORK_WEBSITE,
);

Parameter

Name	Typ	Beschreibung
`query`	`String`	Der String, nach dem in den URLs des Kontakts gesucht werden soll.
`label`	`Field`	das Feld, in dem gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`getContactsByUrl(query, label)`

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Kontakte abrufen, die mit einer URL übereinstimmen, beschränkt auf das angegebene Label für benutzerdefinierte URLs.

// 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".
const contacts = ContactsApp.getContactsByUrl(
    'www.example.com',
    'alternate work',
);

Parameter

Name	Typ	Beschreibung
`query`	`String`	Der String, nach dem in den URLs der Kontakte mit dem angegebenen benutzerdefinierten URL-Label gesucht werden soll
`label`	`String`	das benutzerdefinierte URL-Label, in dem gesucht werden soll

Rückflug

Contact[]: ein Array mit übereinstimmenden Kontakten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)