Diese Seite wurde von der Cloud Translation API übersetzt.

Class ContactsApp

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`	`ExtendedField`
`Field`	`Field`
`Gender`	`Gender`
`Month`	`Month`
`Priority`	`Priority`
`Sensitivity`	`Sensitivity`

Verworfene Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`createContact(givenName, familyName, email)`	`Contact`	Erstellt einen neuen Kontakt.
`createContactGroup(name)`	`ContactGroup`	Erstellt eine Kontaktgruppe mit dem angegebenen Namen
`deleteContact(contact)`	`void`	Löscht den Kontakt.
`deleteContactGroup(group)`	`void`	Löscht die Kontaktgruppe
`findByEmailAddress(email)`	`Contact`	Findet einen Kontakt mit der angegebenen E-Mail-Adresse.
`findContactGroup(name)`	`ContactGroup`	Findet eine Kontaktgruppe mit dem angegebenen Namen.
`getAllContacts()`	`Contact[]`	Ruft alle Kontakte dieses Nutzers ab.
`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[]`	Hiermit werden Kontakte abgerufen, die mit einer Adresse übereinstimmen (auf ein bestimmtes Feld beschränkt).
`getContactsByAddress(query, label)`	`Contact[]`	Ruft Kontakte ab, die mit einer Adresse übereinstimmen, beschränkt auf das angegebene benutzerdefinierte Adresslabel.
`getContactsByCompany(query)`	`Contact[]`	Mit dem Unternehmensfeld übereinstimmende Kontakte abrufen.
`getContactsByCustomField(query, label)`	`Contact[]`	Kontakte abrufen, die mit einem bestimmten Wert in einem benutzerdefinierten Feld übereinstimmen.
`getContactsByDate(month, day, label)`	`Contact[]`	Rufen Sie Kontakte ab, die einem bestimmten Monat und einem bestimmten Tag für ein bestimmtes Standardfeld entsprechen.
`getContactsByDate(month, day, year, label)`	`Contact[]`	Hiermit können Sie Kontakte abrufen, die einem bestimmten Monat, Tag und Jahr für ein bestimmtes Standardfeld entsprechen.
`getContactsByDate(month, day, year, label)`	`Contact[]`	Rufen Sie Kontakte ab, die einem bestimmten Monat, Tag und Jahr für ein bestimmtes benutzerdefiniertes Feld entsprechen.
`getContactsByDate(month, day, label)`	`Contact[]`	Rufen Sie Kontakte ab, die einem bestimmten Monat und einem bestimmten Tag für ein bestimmtes benutzerdefiniertes Feld entsprechen.
`getContactsByEmailAddress(query)`	`Contact[]`	Rufen Sie Kontakte ab, die mit einer E-Mail-Adresse übereinstimmen.
`getContactsByEmailAddress(query, label)`	`Contact[]`	Hiermit können Sie Kontakte abrufen, die mit einer E-Mail-Adresse übereinstimmen (auf ein bestimmtes Feld beschränkt).
`getContactsByEmailAddress(query, label)`	`Contact[]`	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.
`getContactsByGroup(group)`	`Contact[]`	Ruft die Kontakte in einer bestimmten ContactGroup ab.
`getContactsByIM(query)`	`Contact[]`	Rufen Sie Kontakte ab, die einer Instant Messaging-Adresse entsprechen.
`getContactsByIM(query, label)`	`Contact[]`	Hiermit können Sie Kontakte abrufen, die mit einer Instant Messaging-Adresse übereinstimmen (auf ein bestimmtes Feld beschränkt).
`getContactsByIM(query, label)`	`Contact[]`	Kontakte abrufen, die einer Instant Messaging-Adresse entsprechen, beschränkt auf die angegebene benutzerdefinierte Instant-Version Nachrichtenlabel.
`getContactsByJobTitle(query)`	`Contact[]`	Rufen Sie Kontakte ab, die dem Feld für die Stellenbezeichnung 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 Notizfeld übereinstimmen.
`getContactsByPhone(query)`	`Contact[]`	Rufen Sie Kontakte ab, die einer Telefonnummer entsprechen.
`getContactsByPhone(query, label)`	`Contact[]`	Sie können Kontakte abrufen, die mit einer Telefonnummer übereinstimmen (auf ein bestimmtes Feld beschränkt).
`getContactsByPhone(query, label)`	`Contact[]`	Hiermit werden Kontakte abgerufen, die mit einer Telefonnummer übereinstimmen, begrenzt auf das angegebene benutzerdefinierte Telefonnummernlabel.
`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[]`	Hiermit werden Kontakte abgerufen, die mit einer URL übereinstimmen, begrenzt auf das angegebene benutzerdefinierte URL-Label.

Verworfene Methoden

`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

Contact: das neu erstellte Kontaktobjekt

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)

`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

ContactGroup: die neu erstellte 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

deleteContactGroup(group)

`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`	`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

createContact(givenName, familyName, email)

`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`	`ContactGroup`	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

createContactGroup(name)

`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

Contact: der Kontakt, der diese E-Mail-Adresse enthält

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`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

ContactGroup: Die Kontaktgruppe, die dem angegebenen Namen entspricht

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getAllContacts()`

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Ruft alle Kontakte dieses Nutzers ab.

Rückflug

Contact[]: alle Kontakte dieses Nutzers

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`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

Contact – der Kontakt, der diese E-Mail-Adresse enthält

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`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

Contact: der übereinstimmende Kontakt oder null

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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

ContactGroup: die übereinstimmende Kontaktgruppe oder null, wenn keine entsprechende Kontaktgruppe gefunden wird

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContactGroups()

`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

ContactGroup: die übereinstimmende Kontaktgruppe oder null, wenn keine entsprechende Kontaktgruppe gefunden wird

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

ContactGroup[]: ein Array der Kontaktgruppen des Nutzers

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)

`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

Contact[]: ein Array aller Kontakte des Nutzers

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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`	`Field`	das Feld für die Suche

Rückflug

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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`	`ExtendedField`	das benutzerdefinierte Feld für die Suche

Rückflug

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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`	`Field`	das Feld, in dem gesucht werden soll, aus „ContactsApp.Field“

Rückflug

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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`	`Field`	das Feld, in dem gesucht werden soll, aus „ContactsApp.Field“

Rückflug

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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`	`Field`	das Feld für die Suche

Rückflug

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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`	`ContactGroup`	die Gruppe der Kontakte

Rückflug

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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`	`Field`	das Feld für die Suche

Rückflug

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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`	`Field`	das Feld für die Suche

Rückflug

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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`	`Field`	das Feld für die Suche

Rückflug

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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`	`Field`	das Feld für die Suche

Rückflug

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)

`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

Contact[]: ein Array übereinstimmender Kontakte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen

getContact(emailAddress)