Domain Shared Contacts API – Übersicht

Mit der Domain Shared Contacts API können Ihre Anwendungen externe Kontakte abrufen und aktualisieren, die für alle Nutzer in einer Google Workspace-Domain freigegeben sind. Freigegebene Kontakte sind für alle Nutzer einer Google Workspace-Domain sichtbar und alle Google-Dienste haben Zugriff auf die Kontaktliste.

Ihre Anwendung kann die Domain Shared Contacts API verwenden, um gemeinsame Kontakte zu erstellen, vorhandene freigegebene Kontakte zu bearbeiten oder zu löschen und um freigegebene Kontakte, die einem bestimmten Kriterium entsprechen, abzufragen.

Die Domain Shared Contacts API ist nur für Google Workspace-Konten verfügbar. Wenn Sie die API verwenden möchten, aktivieren Sie die Domain Shared Contacts API in der Admin-Konsole. Es kann bis zu 24 Stunden dauern, bis Änderungen an freigegebenen Kontakten in der automatischen Vervollständigung von E-Mail-Adressen und im Kontaktmanager berücksichtigt werden.

Dieses Dokument enthält Hintergrundinformationen zu den Funktionen der Domain Shared Contacts API. Es enthält Beispiele zur Verwaltung von Kontakten mithilfe von XML und HTTP. In diesem Dokument erfahren Sie mehr über die Interaktion mit der API mithilfe unserer Clientbibliotheken.

Zielgruppe

Dieses Dokument richtet sich an Entwickler, die Clientanwendungen schreiben möchten, die die Kontaktlisten von Google mithilfe von HTTP und XML bearbeiten können. In diesem Dokument wird davon ausgegangen, dass Sie mit den Grundlagen des Google Data APIs-Protokolls vertraut sind.

Wenn Sie ein UNIX-Betriebssystem verwenden und die Beispiele in diesem Dokument ausprobieren möchten, ohne Code zu schreiben, verwenden Sie die UNIX-Befehlszeilendienstprogramme curl oder wget. cURL mit Google Data-Diensten verwenden

Grundprinzip

Diese Version der Domain Shared Contacts API entspricht den Prinzipien der Google Data APIs. Google Data APIs basieren neben dem Atom Publishing Protocol auch auf den Syndikationsformaten Atom 1.0 und RSS 2.0.

Version angeben

Für jede Anfrage, die Sie über die Domain Shared Contacts API senden, muss Version 3.0 der API angegeben werden:

GData-Version: 3.0

Wenn Sie keine HTTP-Header festlegen können, können Sie v=3.0 als Abfrageparameter in der URL angeben. Die HTTP-Header-Methode wird jedoch empfohlen.