Wichtig: Migrieren Sie Ihre Skripts vom Kontakte-Dienst zum erweiterten Dienst der People API, bevor der Kontakte-Dienst von Apps Script im März 2023 eingestellt wird.
Apps Script hat den Kontakte-Dienst am 16. Dezember 2022 eingestellt. Verwenden Sie stattdessen den erweiterten People API-Dienst. 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 Kontaktdienstmethoden im erweiterten People API-Dienst keine Entsprechung haben. Außerdem erfahren Sie, was Sie stattdessen verwenden können, und Sie finden Codebeispiele für die Migration gängiger Aufgaben. Weitere Informationen finden Sie im Migrationsleitfaden zur Contact API.
Methoden ohne People API-Entsprechungen
Im Folgenden sind die getContacts
-Methoden im Kontakte-Dienst aufgeführt, die keine entsprechenden Möglichkeiten zum Suchen nach Kontakten im erweiterten People API-Dienst bieten. 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 Kontaktdienst 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 partiellen Äquivalenten |
---|
|
Zusätzliche Funktionen, die mit der People API verfügbar sind
Bei der Migration zum erweiterten People API-Dienst können Sie auf die folgenden People API-Funktionen zugreifen, die im Kontakte-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. nach einem Google-Kontakt oder einem Google-Profil.
- Personen anhand eines Abfragestrings suchen: Sie können eine Liste mit Profilen und Kontakten abrufen, die einem bestimmten String entsprechen.
- Batchanfragen: Sie können Ihre People API-Aufrufe in Batches zusammenfassen, um die Ausführungszeit des Skripts zu verkürzen.
Codebeispiele für häufige Aufgaben
In diesem Abschnitt werden häufige Aufgaben von Google Kontakte aufgeführt. Die Codebeispiele zeigen, wie die Aufgaben mit dem erweiterten People API-Dienst erstellt werden.
Kontaktgruppe nach Namen abrufen
Das folgende Codebeispiel zeigt, wie Sie eine Kontaktgruppe anhand ihres Namens abrufen, der getContactGroup(name)
im Kontaktedienst entspricht.
Kontakt über E-Mail-Adresse anfordern
Das folgende Codebeispiel zeigt, wie Sie einen Kontakt über seine E-Mail-Adresse abrufen. Dies entspricht getContact(emailAddress)
im Kontaktedienst.
Alle Kontakte abrufen
Das folgende Codebeispiel zeigt, wie Sie alle Kontakte eines Nutzers abrufen. Dies entspricht getContacts()
im Kontaktedienst.
Vollständigen Namen eines Kontakts abrufen
Das folgende Codebeispiel zeigt, wie Sie den vollständigen Namen eines Kontakts abrufen. Er entspricht getFullName()
im Kontaktedienst.
Alle Telefonnummern für einen Kontakt abrufen
Das folgende Codebeispiel zeigt, wie Sie alle Telefonnummern für einen Kontakt abrufen. Dies entspricht getPhones()
im Google Kontakte-Dienst.
Eine bestimmte Telefonnummer für einen Kontakt abrufen
Das folgende Codebeispiel zeigt, wie Sie eine bestimmte Telefonnummer für einen Kontakt abrufen. Dies entspricht getPhoneNumber()
im Google Kontakte-Dienst.