Interfejs Domain Shared Contacts API umożliwia aplikacjom pobieranie i aktualizowanie kontaktów zewnętrznych udostępnianych wszystkim użytkownikom w domenie Google Workspace. Udostępnione kontakty są widoczne dla wszystkich użytkowników domeny Google Workspace, a wszystkie usługi Google mają dostęp do listy kontaktów.
Twoja aplikacja może używać interfejsu Domain Shared Contacts API do tworzenia kontaktów udostępnionych, edytowania i usuwania istniejących kontaktów oraz wysyłania zapytań dotyczących kontaktów udostępnionych, które spełniają określone kryteria.
Interfejs API kontaktów udostępnionych w domenie jest dostępny tylko na kontach Google Workspace. Aby korzystać z interfejsu API, włącz interfejs Domain Shared Contacts API w konsoli administracyjnej. Zastosowanie autouzupełniania kontaktów i menedżera kontaktów może potrwać do 24 godzin w przypadku udostępnionych kontaktów.
Ten dokument zawiera informacje na temat możliwości interfejsu Domain Shared Contacts API, a także przykładów zarządzania kontaktami przy użyciu formatu XML i HTTP. Więcej informacji o korzystaniu z interfejsu API znajdziesz w naszych bibliotekach klienta.
Odbiorcy
Ten dokument jest przeznaczony dla programistów, którzy chcą tworzyć aplikacje klienckie służące do manipulowania listami kontaktów Google przy użyciu protokołu HTTP i XML. W tym dokumencie założono, że znasz podstawy protokołu interfejsów API danych Google.
Jeśli korzystasz z systemu operacyjnego UNIX i chcesz wypróbować przykłady w tym dokumencie bez konieczności 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 Google Data API. Interfejsy API danych Google są oparte na formatach dystrybucji Atom 1.0 oraz RSS 2.0, a nie tylko protokołu Atom Publishing Protocol.
Określ wersję
Każde żądanie wysyłane za pomocą interfejsu Domain Shared Contacts API powinno określać wersję interfejsu API 3.0:
GData-Version: 3.0
Jeśli nie możesz ustawić nagłówków HTTP, możesz podać w adresie URL parametr v=3.0
, ale zalecamy metodę nagłówka HTTP.