API для общих контактов домена позволяет вашим приложениям получать и обновлять внешние контакты, которые доступны всем пользователям в домене Google Workspace. Общие контакты видны всем пользователям домена Google Workspace, и все сервисы Google имеют доступ к списку контактов.
Ваше приложение может использовать API общих контактов домена для создания общих контактов, редактирования или удаления существующих общих контактов, а также для поиска общих контактов, соответствующих определенным критериям.
API для общих контактов домена доступен только для учетных записей Google Workspace. Чтобы использовать API, включите его в консоли администратора . Изменения в общих контактах могут отобразиться в автозаполнении адреса электронной почты и в менеджере контактов в течение 24 часов.
Помимо предоставления справочной информации о возможностях API общих контактов домена, этот документ содержит примеры управления контактами с использованием XML и HTTP. После прочтения этого документа вы сможете узнать больше о взаимодействии с API с помощью наших клиентских библиотек .
Аудитория
Этот документ предназначен для разработчиков, которые хотят создавать клиентские приложения, способные управлять списками контактов Google с помощью HTTP и XML. Предполагается, что вы понимаете основы протокола Google Data API .
Если вы используете операционную систему 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-заголовков.