Mit der Domain Shared Contacts API können 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.
Mit der Domain Shared Contacts API können Sie freigegebene Kontakte erstellen, bearbeiten oder löschen und Kontakte abfragen, 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 in der automatischen Vervollständigung und im Kontaktmanager angezeigt werden.
In diesem Dokument finden Sie Hintergrundinformationen zur Domain Shared Contacts API sowie Beispiele für die Verwaltung von Kontakten mit XML und HTTP. Weitere Informationen finden Sie unter Clientbibliotheken.
Zielgruppe
Dieses Dokument richtet sich an Entwickler, die Clientanwendungen schreiben, mit denen Google-Kontaktlisten über HTTP und XML bearbeitet werden. Dabei wird vorausgesetzt, dass Sie mit dem Google Data APIs-Protokoll vertraut sind.
Nutzer von Linux und macOS können die Beispiele in diesem Dokument mit curl oder wget ausprobieren. Weitere Informationen finden Sie unter curl mit Google Data APIs verwenden.
Grundsätze
Die Domain Shared Contacts API folgt den Grundsätzen der Google Data APIs. Google Data APIs basieren auf Atom 1.0, RSS 2.0 und dem Atom Publishing Protocol.
Version angeben
In allen Anfragen, die mit der Domain Shared Contacts API gesendet werden, sollte Version 3.0 angegeben werden:
GData-Version: 3.0
Wenn Sie keine HTTP-Header festlegen können, geben Sie v=3.0 als Abfrageparameter an.
Die HTTP-Header-Methode wird empfohlen.