Der Google Kontakte-Dienst wurde in Apps Script am 16. Dezember 2022 eingestellt. Verwenden Sie stattdessen den erweiterten Dienst der People API. Die People API verwendet ein neueres JSON-Protokoll und bietet erweiterte Funktionen wie das Zusammenführen von Kontakten mit Profilen.
In diesem Leitfaden erfahren Sie, welche Methoden des Google Kontakte-Dienstes keine Entsprechung im erweiterten Dienst der People API haben, was Sie stattdessen verwenden können und wo Sie Codebeispiele für die Migration häufiger Aufgaben finden. Weitere Informationen finden Sie im Leitfaden zur Migration der Contacts API.
Methoden ohne Entsprechung in der People API
Im Folgenden finden Sie eine Liste von getContacts
Methoden im Google Kontakte-Dienst, für die es keine entsprechenden Möglichkeiten gibt, im erweiterten Dienst der People API nach Kontakten zu suchen. Mit dem erweiterten Dienst der People API können Sie nach den Feldern names
, nickNames
, emailAddresses
, phoneNumbers
und organizations
eines Kontakts suchen, die aus der Quelle CONTACT
stammen.
Methoden ohne Äquivalente |
---|
|
Im Folgenden sind getContacts
-Methoden aus dem Google Kontakte-Dienst aufgeführt, die einen zusätzlichen label
-Parameter verwenden. Sie können searchContacts
aus dem erweiterten Dienst der People API verwenden, um Kontakte anhand des entsprechenden Felds abzurufen. Sie können die Suche jedoch nicht auf ein bestimmtes Label beschränken.
Methoden mit teilweisen Äquivalenten |
---|
|
Zusätzliche Funktionen der People API
Wenn Sie zum erweiterten People API-Dienst migrieren, können Sie auf die folgenden People API-Funktionen zugreifen, die im Contacts-Dienst nicht verfügbar sind:
- Datenquelle angeben: Wenn Sie nach Informationen zu einer Person suchen, können Sie angeben, wo gesucht werden soll, z. B. in einem Google-Kontakt oder einem Google-Profil.
- Nach Personen anhand eines Suchstrings suchen: Sie können eine Liste mit Profilen und Kontakten abrufen, die mit einem bestimmten String übereinstimmen.
- Batchanfragen: Sie können Ihre People API-Aufrufe in Batches zusammenfassen, um die Ausführungszeit des Scripts zu verkürzen.
Codebeispiele für gängige Aufgaben
In diesem Abschnitt werden häufige Aufgaben des Google Kontakte-Dienstes aufgeführt. Die Codebeispiele zeigen, wie Sie die Aufgaben mit dem erweiterten Dienst der People API erstellen.
Kontaktgruppe anhand des Namens abrufen
Im folgenden Codebeispiel wird gezeigt, wie eine Kontaktgruppe anhand ihres Namens abgerufen wird. Das entspricht getContactGroup(name)
im Google Kontakte-Dienst.
Kontakt anhand der E-Mail-Adresse abrufen
Im folgenden Codebeispiel wird gezeigt, wie ein Kontakt anhand seiner E-Mail-Adresse abgerufen wird. Das entspricht getContact(emailAddress)
im Google Kontakte-Dienst.
Alle Kontakte abrufen
Im folgenden Codebeispiel wird gezeigt, wie alle Kontakte eines Nutzers abgerufen werden. Das entspricht getContacts()
im Contacts-Dienst.
Vollständigen Namen eines Kontakts abrufen
Im folgenden Codebeispiel wird gezeigt, wie Sie den vollständigen Namen eines Kontakts abrufen, was im Google Kontakte-Dienst dem Attribut getFullName()
entspricht.
Alle Telefonnummern für einen Kontakt abrufen
Im folgenden Codebeispiel wird gezeigt, wie Sie alle Telefonnummern für einen Kontakt abrufen, was im Google Kontakte-Dienst dem Attribut getPhones()
entspricht.
Eine bestimmte Telefonnummer für einen Kontakt abrufen
Im folgenden Codebeispiel wird gezeigt, wie eine bestimmte Telefonnummer für einen Kontakt abgerufen wird. Das entspricht getPhoneNumber()
im Contacts-Dienst.