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.
Mit der Domain Shared Contacts API können Sie in Ihrer Anwendung freigegebene Kontakte erstellen, vorhandene freigegebene Kontakte bearbeiten oder löschen und nach freigegebenen Kontakten suchen, 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, 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 angezeigt werden.
Dieses Dokument enthält nicht nur Hintergrundinformationen zu den Funktionen der Domain Shared Contacts API, sondern auch Beispiele zur Verwaltung von Kontakten mit XML und HTTP. 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 die Kontaktlisten von Google mithilfe von HTTP und XML manipuliert 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. Weitere Informationen zur Verwendung von cURL mit Google-Datendiensten
Grundsätze
Diese Version der Domain Shared Contacts API folgt den Prinzipien der Google Data APIs. Die Google Data APIs basieren neben dem Atom Publishing Protocol auf den Syndication-Formaten Atom 1.0 und RSS 2.0.
Version angeben
Bei jeder 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.