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

Запросить общие контакты пользователей можно следующими способами:

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

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

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

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

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

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

    • DOMAIN : Ваш домен. Например, example.com.
    • PROJECTION : Значение проекции. Список поддерживаемых значений см. в разделе «Значения проекции» .

    Сервер возвращает код состояния 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>

  2. В ответе на запрос ленты содержится максимум 10 МБ данных. Чтобы получить полный список, несколько раз перейдите по ссылке «Далее» в полученном ответе.

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

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

  1. Отправьте HTTP GET запрос на URL-адрес ленты контактов с параметром:

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

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

    Например, чтобы обновлять записи после 16 марта 2022 года для сайта example.com, добавьте параметр updated-min :

    GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00

    Сервер возвращает код состояния HTTP 200 OK и ленту с результатами поиска.

  2. В ответе на запрос ленты содержится максимум 10 МБ данных. Чтобы получить полный список, несколько раз перейдите по ссылке «Далее» в полученном ответе.

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

Чтобы отслеживать изменения в общем списке контактов домена: 1. Запишите значение элемента <updated> в ленте. 2. Запросите информацию об измененных контактах, установив updated-min равным этому значению <updated> и showdeleted равным true .

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

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

  1. Чтобы получить доступ к конкретному контакту, отправьте HTTP GET запрос по ссылке на страницу контакта:
    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/SELF_LINK
     Замените следующее:
  • DOMAIN : Ваш домен — например, example.com.
  • PROJECTION : Значение проекции. Список поддерживаемых значений см. в разделе «Значения проекции» .
  • SELF_LINK : Уникальное числовое значение контакта.

Сервер возвращает код состояния HTTP 200 OK и запись контакта.

Например, чтобы получить контакт с помощью ссылки «Самостоятельно» https://www.google.com/m8/feeds/contacts/example.com/full/12345 :

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

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