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 gemeinsame Kontakte zu bearbeiten oder zu löschen und freigegebene Kontakte abzufragen, die einem bestimmten Kriterium entsprechen.
Die Domain Shared Contacts API ist nur für Google Workspace-Konten verfügbar. Um die API zu verwenden, aktivieren Sie die Domain Shared Contacts API in der Admin-Konsole. Es kann bis zu 24 Stunden dauern, bis Änderungen am freigegebenen Kontakt in der automatischen Vervollständigung der E-Mail-Adresse und im Kontaktmanager zu sehen sind.
In diesem Dokument werden nicht nur Hintergrundinformationen zu den Funktionen der Domain Shared Contacts API, sondern auch Beispiele zur Verwaltung von Kontakten mithilfe von XML und HTTP bereitgestellt. Nach dem Lesen dieses Dokuments können Sie mehr über die Interaktion mit der API und unseren Clientbibliotheken erfahren.
Zielgruppe
Dieses Dokument richtet sich an Entwickler, die Clientanwendungen schreiben möchten, die die Kontaktlisten von Google mithilfe von HTTP und XML bearbeiten. 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 schreiben zu müssen, verwenden Sie die UNIX-Befehlszeilendienstprogramme curl oder wget. cURL mit Google Data-Diensten verwenden
Grundprinzip
Diese Version der Domain Shared Contacts API entspricht den Grundsätzen der Google Data APIs. Google Data APIs basieren sowohl auf dem Atom-Publishing-Protokoll als 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, 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.