Interfejs Domain Shared Contacts API umożliwia aplikacjom pobieranie i aktualizowanie kontaktów zewnętrznych udostępnionych wszystkim użytkownikom w domenie Google Workspace. Kontakty udostępnione są widoczne dla wszystkich użytkowników domeny Google Workspace, a wszystkie usługi Google mają dostęp do listy kontaktów.
Aplikacja może używać interfejsu Domain Shared Contacts API do tworzenia kontaktów udostępnionych, edytowania lub usuwania istniejących kontaktów udostępnionych oraz wyszukiwania kontaktów udostępnionych, które spełniają określone kryteria.
Interfejs Domain Shared Contacts API jest dostępny tylko na kontach Google Workspace. Aby korzystać z interfejsu API, włącz go w konsoli administracyjnej. Zastosowanie zmian w kontaktach udostępnionych w autouzupełnianiu adresów e-mail i w menedżerze kontaktów może potrwać do 24 godzin.
Oprócz informacji o możliwościach interfejsu Domain Shared Contacts API ten dokument zawiera przykłady zarządzania kontaktami za pomocą XML i HTTP. Po przeczytaniu tego dokumentu możesz dowiedzieć się więcej o interakcji z interfejsem API, korzystając z naszych bibliotek klienta.
Odbiorcy
Ten dokument jest przeznaczony dla deweloperów, którzy chcą pisać aplikacje klienckie, które mogą manipulować listami kontaktów Google za pomocą protokołu HTTP i XML. W tym dokumencie zakładamy, że znasz podstawy protokołu interfejsów API danych Google.
Jeśli używasz systemu operacyjnego UNIX i chcesz wypróbować przykłady w tym dokumencie bez pisania kodu, użyj narzędzi wiersza poleceń UNIX curl lub wget. Dowiedz się, jak używać cURL z usługami danych Google.
Zasady
Ta wersja interfejsu Domain Shared Contacts API jest zgodna z zasadami interfejsów API Google do danych. Interfejsy Google Data API są oparte na formatach syndykacji Atom 1.0 i RSS 2.0, a także na protokole publikowania Atom.
Określanie wersji
Każde żądanie wysyłane za pomocą interfejsu Domain Shared Contacts API powinno określać wersję 3.0 interfejsu API:
GData-Version: 3.0
Jeśli nie możesz ustawić nagłówków HTTP, możesz określićv=3.0 jako parametr zapytania w adresie URL, ale zalecana jest metoda nagłówka HTTP.