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 freigegebene Kontakte zu erstellen, vorhandene freigegebene Kontakte zu bearbeiten oder zu löschen und freigegebene Kontakte abzufragen, die bestimmten Kriterien entsprechen.
Die Domain Shared Contacts API ist nur für Google Workspace-Konten verfügbar. Wenn Sie die API verwenden möchten, müssen Sie die Domain Shared Contacts API in der Admin-Konsole aktivieren. Es kann bis zu 24 Stunden dauern, bis Änderungen an freigegebenen Kontakten in der automatischen Vervollständigung von E‑Mail-Adressen und im Kontaktmanager angezeigt werden.
In diesem Dokument werden nicht nur die Funktionen der Domain Shared Contacts API erläutert, sondern auch Beispiele für die Verwaltung von Kontakten mit XML und HTTP bereitgestellt. Nachdem Sie dieses Dokument gelesen haben, können Sie mehr über die Interaktion mit der API mithilfe unserer Clientbibliotheken erfahren.
Zielgruppe
Dieses Dokument richtet sich an Entwickler, die Clientanwendungen schreiben möchten, mit denen Kontaktlisten von Google über HTTP und XML bearbeitet werden können. In diesem Dokument wird davon ausgegangen, dass Sie die Grundlagen des Google Data APIs-Protokolls kennen.
Wenn Sie ein UNIX-Betriebssystem verwenden und die Beispiele in diesem Dokument ausprobieren möchten, ohne Code zu schreiben, verwenden Sie die UNIX-Befehlszeilenprogramme curl oder wget. cURL mit Google-Datendiensten verwenden
Grundsätze
Diese Version der Domain Shared Contacts API folgt den Prinzipien der Google Data APIs. Google Data APIs basieren auf den Syndikationsformaten Atom 1.0 und RSS 2.0 sowie auf dem Atom Publishing Protocol.
Version angeben
In jeder Anfrage, die Sie mit der Domain Shared Contacts API senden, sollte 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.