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