Interfejs Domain Shared Contact API – omówienie

Interfejs Domain Shared Contacts API pozwala aplikacjom pobierać i aktualizować kontakty zewnętrzne, które są udostępniane wszystkim użytkownikom w domenie Google Workspace. Kontakty udostępnione są widoczne dla wszystkich użytkowników w domenie Google Workspace, a wszystkie usługi Google mają dostęp do listy kontaktów.

Aplikacja może korzystać z interfejsu Domain Shared Contacts API do tworzenia kontaktów udostępnionych, edytowania i usuwania istniejących kontaktów udostępnionych oraz wysyłania zapytań o kontakty udostępnione, które spełniają określone kryteria.

Interfejs Domain Shared Contacts API jest dostępny tylko na kontach Google Workspace. Aby korzystać z tego interfejsu, włącz w konsoli administracyjnej interfejs Domain Shared Contacts API. Zanim zmiany kontaktów udostępnionych zostaną uwzględnione w autouzupełnianiu adresu e-mail i w menedżerze kontaktów, może upłynąć do 24 godzin.

Oprócz przedstawienia ogólnych informacji o możliwościach interfejsu Domain Shared Contact API, podano również przykłady tego, jak zarządzać kontaktami za pomocą XML i HTTP. Z tego dokumentu dowiesz się więcej o korzystaniu z tego interfejsu API za pomocą naszych bibliotek klienta.

Odbiorcy

Ten dokument jest przeznaczony dla programistów, którzy chcą tworzyć aplikacje klienckie mogące manipulować listami kontaktów Google przy użyciu protokołów HTTP i XML. W tym dokumencie zakładamy, że znasz podstawy protokołu Google Data API.

Jeśli używasz systemu operacyjnego UNIX i chcesz wypróbować przykłady z tego dokumentu bez pisania kodu, użyj narzędzi wiersza poleceń UNIX curl lub wget. Dowiedz się, jak używać cURL z usługami dotyczącymi danych Google.

Zasady

Ta wersja interfejsu Domain Shared Contacts API jest zgodna z zasadami interfejsów API danych Google. Interfejsy API danych Google opierają się na formatach dystrybucji Atom 1.0 i RSS 2.0 oprócz protokołu Atom Publishing Protocol.

Określ wersję

Każde żądanie wysyłane za pomocą interfejsu API kontaktów udostępnionych w domenie powinno określać wersję 3.0 API:

GData-Version: 3.0

Jeśli nie możesz ustawić nagłówków HTTP, jako parametr zapytania w adresie URL możesz określić v=3.0, ale zalecamy używanie nagłówka HTTP.