API для общих контактов домена позволяет приложениям получать и обновлять внешние контакты, доступные всем пользователям в домене Google Workspace. Общие контакты видны всем пользователям домена Google Workspace, и все сервисы Google имеют доступ к списку контактов.
Используйте API общих контактов домена для создания, редактирования или удаления общих контактов, а также для поиска контактов, соответствующих определенным критериям.
API для общих контактов домена доступен только для учетных записей Google Workspace. Чтобы использовать API, включите его в консоли администратора . Изменения могут отобразиться в автозаполнении и менеджере контактов в течение 24 часов.
В этом документе представлена справочная информация об API общих контактов домена и примеры управления контактами с использованием XML и HTTP. Для получения дополнительной информации см. клиентские библиотеки .
Аудитория
Этот документ предназначен для разработчиков, создающих клиентские приложения, которые обрабатывают списки контактов Google с использованием HTTP и XML. Предполагается, что они знакомы с протоколом Google Data API .
Пользователи Linux и macOS могут попробовать примеры из этого документа, используя curl или wget . См. раздел «Использование curl с Google Data API» .
Принципы
API для обмена контактами между доменами основан на принципах API данных Google . API данных Google базируются на Atom 1.0, RSS 2.0 и протоколе публикации Atom.
Укажите версию
Во всех запросах, отправляемых с использованием API общих контактов домена, следует указывать версию 3.0:
GData-Version: 3.0
Если невозможно установить HTTP-заголовки, укажите v=3.0 в качестве параметра запроса. Рекомендуется использовать метод установки HTTP-заголовков.