Эта страница переведена с помощью Cloud Translation API.

Обзор API общих контактов домена

API общих контактов домена позволяет вашим приложениям получать и обновлять внешние контакты, к которым имеют доступ все пользователи в домене Google Workspace. Общие контакты видны всем пользователям домена Google Workspace, и все службы Google имеют доступ к списку контактов.

Предупреждение. API общих контактов домена предназначен только для внешних контактов. Использование этого API для создания контактной информации для доменных (внутренних) пользователей или групп может привести к дублированию контактной информации для этих пользователей и групп, что может привести к непредвиденному поведению. Чтобы получить и обновить контактную информацию (внутренних) пользователей домена Google Workspace, используйте Directory API .

Ваше приложение может использовать 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 общих контактов домена, должен указывать версию 3.0 API:

GData-Version: 3.0

Если вы не можете установить заголовки HTTP, вы можете указать v=3.0 в качестве параметра запроса в URL-адресе, но рекомендуется использовать метод заголовка HTTP.