Migrationsanleitung für die Kontakte API

Die Contacts API wurde am 19. Januar 2022 eingestellt. In dieser Anleitung erfahren Sie mehr über Änderungen an Feldern, Endpunkten und Autorisierungsbereichen bei der Migration zur People API.

Überblick

Die People API hat in allen Funktionen dieselben Funktionen wie die alte Contacts API, mit folgenden Ausnahmen für Weitere Kontakte:

  • Administratoren haben durch den neuen Bereich Leseberechtigungen für „Weitere Kontakte“. Da das Senden von mutate-/write-Signalen an „Weitere Kontakte“ nicht unterstützt wird, müssen Ihre Nutzer diesen weiteren Kontakt unter „Mein Kontakt“ hinzufügen, wenn sie ihre Datenfelder aktualisieren möchten.

  • Über die API können nur grundlegende Kontaktdaten für "Weitere Kontakte" gelesen werden. Zum Beispiel den vollständigen Namen, die E-Mail-Adresse und die Telefonnummer.

Darüber hinaus wird der alte Kontaktbereich (https://www.google.com/m8/feeds, der Zugriff auf persönliche Kontakte und Verzeichnisinformationen ermöglicht hat) durch folgende Bereiche ersetzt:

  • So greifen Sie auf persönliche Kontakte zu: https://www.googleapis.com/auth/contacts
  • So greifen Sie auf Verzeichnisinformationen zu: https://www.googleapis.com/auth/directory.readonly

Kontakte

Feldzuordnung

Kontaktfeld Personenfeld
atom:content Biografien
atom:link rel='http://schemas.google.com/contacts/2008/rel#photo' Fotos
atom:title names
gContact:abrechnungsinformationen miscKeywords (type=OUTLOOK_BILLING_INFORMATION)
gContact:geburtstag Geburtstage
gContact:KalenderLink calendarUrls
gContact:verzeichnisServer miscKeywords (type=OUTLOOK_DIRECTORY_SERVER)
gContact:Ereignis Ereignisse
gContact:extendedProperty clientData
gContact:externalId externalIds
gContact:fileAs fileAses
gContact:Geschlecht Geschlechter
gContact:groupMembershipInfo memberships.contactGroupMembership
gContact:hobby Interessen
gContact:Initialen EINGESTELLTE Spitznamen (type=INITIALS)
gContact:jot type='home' miscKeywords (type=HOME)
gContact:jot type='Keywords' miscKeywords (type=OUTLOOK_KEYWORD)
gContact:jot type='other' miscKeywords (type=OTHER)
gContact:jot type='user' miscKeywords (type=OUTLOOK_USER)
gContact:jot type='work' miscKeywords (type=WORK)
gContact:Sprache Sprachen
gContact:maidenName EINGESTELLTE Spitznamen (type=MAIDEN_NAME)
gContact:mileage miscKeywords (type=OUTLOOK_MILEAGE)
gContact:Spitzname Spitznamen (Typ=STANDARD)
gContact:Beruf Berufe
gContact:Priorität miscKeywords (type=OUTLOOK_PRIORITY)
gKontakt:Beziehung Beziehungen
gContact:Vertraulichkeit miscKeywords (type=OUTLOOK_SENSITIVITY)
gContact:Kurzname EINGESTELLTE Spitznamen (type=SHORT_NAME)
gContact:subject miscKeywords (type=OUTLOOK_SUBJECT)
gContact:userDefinedField userDefined
gContact:website urls
gContact:yomiName names.phonetic_full_name
gd:gelöscht metadata.deleted
gd:email emailAddresses
gd:im imClients
gd:Organisation organizations
gd:phoneNumber phoneNumbers
gd:postalAddress addresses.formattedValue
gd:wo Wohnungen
gd:structuredPostalAddress addresses

Endpunkte für persönliche Kontakte

Lesen

Erfordert https://www.googleapis.com/auth/contacts- oder https://www.googleapis.com/auth/contacts.readonly-Bereich.

Änderung vorgenommen

Erfordert https://www.googleapis.com/auth/contacts-Bereich. Verwandelt alle Kontaktfelder mit Ausnahme von Fotos.

Fotoänderung

Erfordert https://www.googleapis.com/auth/contacts-Bereich.

Endpunkte für weitere Kontakte

Lesen

Andere Kontakte sind schreibgeschützt und es werden nur die Felder names, emailAddresses und phoneNumbers zurückgegeben.

Erfordert https://www.googleapis.com/auth/contacts.other.readonly-Bereich.

Kopieren

Erfordert die Bereiche https://www.googleapis.com/auth/contacts.other.readonly und https://www.googleapis.com/auth/contacts.

Endpunkte der globalen Adressenliste

Erfordert https://www.googleapis.com/auth/directory.readonly-Bereich.

Kontaktgruppen

Feldzuordnung

Kontaktgruppenfeld der Contacts API Feld für People API-Kontaktgruppe
Atom:aktualisiert metadata.updateTime
atom:title name
atom:content name
gd:gelöscht metadata.deleted
systemGroup groupType=SYSTEM_CONTACT_GROUP

Endpunkte

Lesen

Erfordert https://www.googleapis.com/auth/contacts- oder https://www.googleapis.com/auth/contacts.readonly-Bereich.

Änderung vorgenommen

Erfordert https://www.googleapis.com/auth/contacts-Bereich.

Autorisierungsbereiche

Der Legacy-Bereich https://www.google.com/m8/feeds ist ein Alias für den Bereich https://www.googleapis.com/auth/contacts. Das bedeutet, dass vorhandene OAuth-Berechtigungen mit dem alten Bereich für alle Endpunkte in der People API funktionieren, die den Bereich https://www.googleapis.com/auth/contacts erfordern. Mit dem alten Bereich können Kontakte und Kontaktgruppen gelesen und geschrieben werden.

Für den Zugriff auf „Weitere Kontakte“- oder Verzeichnisdaten sind neue Bereiche für die People API erforderlich. Informationen zu den erforderlichen Bereichen finden Sie oben.

Weitere Informationen finden Sie unter Anfragen autorisieren.

Clientbibliotheken