Receber contatos compartilhados

Solicite contatos de usuários compartilhados das seguintes maneiras:

  • Todos os contatos compartilhados
  • Um conjunto de contatos que correspondem aos critérios especificados
  • Um único contato compartilhado
  • Uma foto para um contato

Por padrão, as entradas em um feed não são ordenadas.

Receber todos os contatos compartilhados

  1. Para receber todos os contatos compartilhados, envie uma solicitação HTTP GET para o URL do feed de contatos:

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

    Substitua:

    • DOMAIN: seu domínio. Por exemplo, example.com.
    • PROJECTION: o valor da projeção. Para valores compatíveis, consulte Valores de projeção.

    O servidor retorna um código de status HTTP 200 OK e um feed Atom 1.0. O exemplo a seguir mostra um feed de contatos com uma entrada:

    <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. Os feeds retornam no máximo 10 MB em uma única resposta. Para acessar a lista completa, clique várias vezes no link Próxima no feed retornado.

Receber contatos compartilhados usando parâmetros de consulta

Solicite contatos que correspondam a critérios especificados, como aqueles atualizados após uma determinada data. Não há suporte para consultas de texto completo e pesquisas de endereços de e-mail. Para todos os parâmetros de consulta, consulte o guia de referência da API Domain Shared Contacts.

  1. Envie uma solicitação HTTP GET para o URL do feed de contatos com um parâmetro:

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

    Substitua:

    Por exemplo, para receber entradas atualizadas após 16 de março de 2022 para example.com, adicione o parâmetro updated-min:

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

    O servidor retorna um código de status HTTP 200 OK e um feed com todas as correspondências.

  2. Os feeds retornam no máximo 10 MB em uma única resposta. Para acessar a lista completa, clique várias vezes no link Próxima no feed retornado.

Acompanhar mudanças incrementais

Para acompanhar as mudanças em uma lista de contatos compartilhada de um domínio: 1. Registre o valor do elemento <updated> do feed. 1. Solicite os contatos alterados definindo updated-min como o valor <updated> e showdeleted como true.

Receber um único contato compartilhado

Para acessar um contato específico, use o link próprio dele, que pode ser encontrado no feed de contatos compartilhados. Para mais informações, consulte Receber todos os contatos compartilhados.

  1. Para receber um contato específico, envie uma solicitação HTTP GET ao link próprio do contato: 
    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/SELF_LINK
     Substitua:
  • DOMAIN: seu domínio, por exemplo, example.com.
  • PROJECTION: o valor da projeção. Para valores compatíveis, consulte Valores de projeção.
  • SELF_LINK: o valor numérico exclusivo do contato.

O servidor retorna um código de status HTTP 200 OK e a entrada de contato.

Por exemplo, para receber um contato com o self link https://www.google.com/m8/feeds/contacts/example.com/full/12345:

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

Próximas etapas