Wichtig: Migrieren Sie Ihre Skripts vom Kontakte-Dienst zur People API bevor Google Kontakte im März eingestellt wird. 2023
Apps Script hat den Kontakte-Dienst am 16. Dezember 2022 eingestellt. Stattdessen verwenden Sie die Erweiterter 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 Kontakt-Dienstmethoden kein Äquivalent im Erweiterter People API-Dienst, Informationen dazu, was Sie stattdessen verwenden können, und Code finden Beispiele für die Migration gängiger Aufgaben. Weitere Informationen finden Sie in der Migrationsanleitung zur Contact API
Methoden ohne People API-Entsprechungen
Im Folgenden finden Sie eine Liste der getContacts
-Methoden im Kontakte-Dienst, die keine
haben
Möglichkeiten zur Suche nach Kontakten im erweiterten Service der People API. Mit
Mit dem erweiterten Dienst der People API können Sie anhand der names
eines Kontakts,
nickNames
, emailAddresses
, phoneNumbers
und organizations
, die
stammen aus CONTACT
Quelle.
Methoden ohne Äquivalente |
---|
|
Im Folgenden sind die getContacts
-Methoden aus Google Kontakte aufgeführt, die eine
Extra
label
-Parameter. Sie können searchContacts
aus dem erweiterten Dienst der People API verwenden, um Kontakte nach dem entsprechenden Feld 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 die folgenden People API-Funktionen, die nicht im Kontakte-Dienst verfügbar sind:
- Datenquelle angeben: Wenn Sie nach Informationen zu einer Person suchen, können Sie angeben, wo die Datenquelle gespeichert werden soll. etwa 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 Batchanfragen ausführen. Ihre People API-Aufrufe an, um die Ausführungszeit Ihres Skripts zu verkürzen.
Codebeispiele für häufige Aufgaben
In diesem Abschnitt werden häufige Aufgaben von Google Kontakte aufgeführt. Der Code Beispiele zeigen, wie die Aufgaben mit der erweiterten People API erstellt werden. Service.
Kontaktgruppe nach Namen abrufen
Das folgende Codebeispiel zeigt, wie Sie eine Kontaktgruppe nach ihrem Namen abrufen.
entspricht getContactGroup(name)
im Kontakte-Dienst.
Kontakt über E-Mail-Adresse anfordern
Das folgende Codebeispiel zeigt, wie Sie einen Kontakt
über seine E-Mail-Adresse erhalten,
Dies entspricht getContact(emailAddress)
im Kontakte-Dienst.
Alle Kontakte abrufen
Das folgende Codebeispiel zeigt, wie alle Kontakte eines Nutzers abgerufen werden.
die
getContacts()
im Kontakte-Dienst gleich.
Vollständigen Namen eines Kontakts abrufen
Im folgenden Codebeispiel wird gezeigt, wie Sie den vollständigen Namen eines Kontakts abrufen. Das ist der
getFullName()
im Kontakte-Dienst gleich.
Alle Telefonnummern für einen Kontakt abrufen
Das folgende Codebeispiel zeigt, wie Sie alle Telefonnummern für eine
contact, was getPhones()
im Kontakte-Dienst entspricht.
Eine bestimmte Telefonnummer für einen Kontakt abrufen
Das folgende Codebeispiel zeigt, wie Sie eine bestimmte Telefonnummer für eine
contact, was getPhoneNumber()
im Kontakte-Dienst entspricht.