Mit der Domain Shared Contacts API können Ihre Anwendungen externe Kontakte, die für alle Nutzer in einer Google Workspace-Domain freigegeben sind. Freigegeben Kontakte sind für alle Nutzer einer Google Workspace-Domain und alle Dienste haben Zugriff auf die Kontaktliste.
Ihre Anwendung kann die Domain Shared Contacts API verwenden, um gemeinsame Kontakte zu erstellen, oder vorhandene gemeinsame Kontakte löschen und nach freigegebenen Kontakten suchen, die einem Kriterien erfüllen.
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 an freigegebenen Kontakten in der E-Mail angezeigt werden. die automatische Vervollständigung von Adressen und den Kontaktmanager.
Zusätzlich zur Bereitstellung von Hintergrundinformationen zu den Fähigkeiten der Domain Shared Contacts API enthält. Dieses Dokument enthält Beispiele zur Verwaltung von Kontakte mithilfe von XML und HTTP. Nachdem Sie dieses Dokument gelesen haben, zur Interaktion mit der API mithilfe der Clientbibliotheken.
Zielgruppe
Dieses Dokument richtet sich an Entwickler, die Clientanwendungen schreiben möchten die die Kontaktlisten von Google mithilfe von HTTP und XML manipulieren können. In diesem Dokument wird davon ausgegangen, dass Sie die Grundlagen des Google Data APIs-Protokolls
Wenn Sie ein UNIX-Betriebssystem verwenden und die Beispiele in diesem ohne Programmieren schreiben zu müssen, verwenden Sie die Befehlszeilendienstprogramme von UNIX curl oder wget. Hier erfahren Sie, wie Sie cURL mit Google-Datendiensten verwenden
Grundsätze
Diese Version der Domain Shared Contacts API entspricht den Prinzipien der Google Data APIs Google Data APIs basieren auf den Syndikationsformaten Atom 1.0 und RSS 2.0. zusätzlich zum Atom Publishing Protocol.
Version angeben
Bei jeder Anfrage, die Sie über die Domain Shared Contacts API senden, sollte die Version angegeben werden. Version 3.0 der API:
GData-Version: 3.0
Wenn Sie keine HTTP-Header festlegen können, geben Sie v=3.0 als Abfrageparameter an.
die URL, aber die HTTP-Header-Methode wird empfohlen.