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

Получить общие контакты

Вы можете запросить общие контакты пользователей различными способами:

Все общие контакты
Набор контактов, соответствующих заданным критериям
Один общий контакт
Фото для контакта

По умолчанию записи в ленте не упорядочены.

Получить все общие контакты

Чтобы получить все общие контакты, отправьте HTTP-запрос GET на URL-адрес канала контактов:

GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION

Замените следующее:

DOMAIN : URL-адрес вашего домена, например example.com.
PROJECTION : значение проекции, определяющее элементы gd:extendedProperty . Список поддерживаемых значений см. в разделе Значения проекции .

Канал возвращает код состояния HTTP 200 OK и стандартный фид Atom 1.0, содержащий контакты. Ниже приведен пример ленты контактов только с одной записью:

<feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
    xmlns:gd='http://schemas.google.com/g/2005'
    xmlns:gContact='http://schemas.google.com/contact/2008'
    xmlns:batch='http://schemas.google.com/gdata/batch'>
  <id>https://www.google.com/m8/feeds/contacts/example.com/base</id>
  <updated>2008-03-05T12:36:38.836Z</updated>
  <category scheme='http://schemas.google.com/g/2005#kind'
    term='http://schemas.google.com/contact/2008#contact' />
  <title type='text'>example.com's Contacts</title>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full' />
  <link rel='http://schemas.google.com/g/2005#post'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full' />
  <link rel='http://schemas.google.com/g/2005#batch'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full/batch' />
  <link rel='self' type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full?max-results=25' />
  <author>
    <name>example.com</name>
    <email>example.com</email>
  </author>
  <generator version='1.0' uri='https://www.google.com/m8/feeds/contacts'>
    Contacts
  </generator>
  <openSearch:totalResults>1</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
  <entry>
    <id>
      https://www.google.com/m8/feeds/contacts/example.com/base/c9012de
    </id>
    <updated>2008-03-05T12:36:38.835Z</updated>
    <category scheme='http://schemas.google.com/g/2005#kind'
      term='http://schemas.google.com/contact/2008#contact' />
    <title type='text'>Fitzgerald</title>
    <gd:name>
      <gd:fullName>Fitzgerald</gd:fullName>
    </gd:name>
    <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*"
      href="http://google.com/m8/feeds/photos/media/example.com/c9012de"/>
    <link rel='self' type='application/atom+xml'
      href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de' />
    <link rel='edit' type='application/atom+xml'
      href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de/1204720598835000' />
    <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'
      primary='true'>
      456
    </gd:phoneNumber>
    <gd:extendedProperty name="pet" value="hamster" />
  </entry>
</feed>

Фид не возвращает более 10 МБ в одном ответе. Чтобы получить весь список контактов, несколько раз переходите по ссылке «Далее» в возвращаемом канале, пока вы не перестанете видеть эту ссылку в ответном канале.

Получите общие контакты, используя параметры запроса

Вы можете запросить набор контактов, соответствующих заданным критериям, например запросить контакты, обновленные после определенной даты. Полнотекстовые запросы или поиск контакта по адресу электронной почты не поддерживаются. Полный список поддерживаемых параметров запроса см. в справочном руководстве по API общих контактов домена .

Отправьте HTTP GET на URL-адрес канала контактов с определенным параметром:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER
```
Замените следующее:
- DOMAIN : URL-адрес вашего домена, например example.com.
- PROJECTION : значение проекции, определяющее элементы gd:extendedProperty . Список поддерживаемых значений см. в разделе Значения проекции .
- PARAMETER : один из поддерживаемых параметров запроса. Дополнительную информацию см. в справочном руководстве по API общих контактов домена .
Например, чтобы обновить все записи общих контактов домена для example.com после 16 марта 2022 г., отправьте HTTP-запрос на URL-адрес общей ленты контактов домена и добавьте параметр updated-min к URL-адресу запроса:
```
GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00
```
Когда вы отправляете этот запрос GET , сервер возвращает код состояния HTTP 200 OK и канал, содержащий все общие контакты домена, которые были созданы или обновлены после указанной даты.
Фид не возвращает более 10 МБ в одном ответе. Чтобы получить весь список контактов с указанными критериями, несколько раз переходите по ссылке «Далее» возвращаемого канала, пока вы не перестанете видеть эту ссылку в ответном канале.

Отслеживайте постепенные изменения

Чтобы отслеживать дополнительные изменения в общем списке контактов домена, выполните следующие действия: 1. Отправляя запрос на канал, отслеживайте значение элемента <updated> канала. 1. Вы можете получить только те общие контакты домена, которые изменились с момента предыдущего запроса, установив для параметра запроса updated-min это значение <updated> и установив showdeleted значение true .

Получите один общий контакт

Чтобы получить один общий контакт, необходимо использовать собственную ссылку контакта. Получить ссылку на общий контакт можно, только найдя запись о контакте в ленте общих контактов. Если вы не уверены, какое значение использовать для собственной ссылки, см. разделы Получение всех контактов и Получение контактов с помощью параметров запроса .

Чтобы получить общий контакт определенного домена, отправьте HTTP-запрос GET на собственную ссылку контакта:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK>
```
Замените следующее:

DOMAIN : URL-адрес вашего домена, например example.com.
PROJECTION : значение проекции, определяющее элементы gd:extendedProperty . Список поддерживаемых значений см. в разделе Значения проекции .
SELF_LINK : уникальное числовое значение, обозначающее один общий контакт, например 12345.

Затем сервер возвращает код состояния HTTP 200 OK и запись, содержащую контакт.

Например, чтобы получить общий контакт домена с собственной ссылкой https://www.google.com/m8/feeds/contacts/example.com/full/12345 , отправьте следующий HTTP-запрос:

GET https://www.google.com/m8/feeds/contacts/example.com/full/12345

Следующие шаги

Получить фотографию для общего контакта