Esta página foi traduzida pela API Cloud Translation.

Receber contatos compartilhados

Você pode solicitar contatos compartilhados de usuários de várias formas, maneiras:

Todos os contatos compartilhados
Um conjunto de contatos que corresponde a um critério especificado
Um único contato compartilhado
A foto de um contato

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

Recuperar todos os contatos compartilhados

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

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

Substitua:

DOMAIN: o URL do seu domínio, por exemplo, exemplo.com.
PROJECTION: o valor de projeção que especifica os elementos gd:extendedProperty. Para uma lista de valores compatíveis, consulte Valores de projeção.

O feed retorna um código de status HTTP 200 OK e um Atom 1.0 padrão feed que contém os contatos. Este é um exemplo de uma lista com apenas 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>

O feed não retorna mais de 10 MB em uma única resposta. Para obter a lista de contatos inteira, seguir repetidamente o Próximo link até que ele não apareça mais no feed de retorno.

Acessar contatos compartilhados usando parâmetros de consulta

Você pode solicitar um conjunto de contatos que correspondam a uma como a solicitação de contatos atualizados após uma determinada data. Não há suporte para consultas de texto completo ou localização de um contato por endereço de e-mail. Para um de parâmetros de consulta compatíveis, consulte Guia de referência da API Domain Shared Contacts.

Envie uma solicitação HTTP GET para o URL do feed de contatos com um :
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER
```
Substitua:
- DOMAIN: o URL do seu domínio, por exemplo, exemplo.com.
- PROJECTION: o valor de projeção que especifica os elementos gd:extendedProperty. Para uma lista de valores compatíveis, consulte Valores de projeção.
- PARAMETER: uma das consultas compatíveis parâmetros. Para mais informações, consulte Guia de referência da API Domain Shared Contacts.
Por exemplo, para acessar todas as entradas de contatos compartilhados do domínio atualizadas após 16 de março de 2022 para example.com, enviar uma solicitação HTTP ao domínio compartilhado URL do feed de contato e adicione o parâmetro updated-min ao URL da solicitação:
```
GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00
```
Quando você envia essa solicitação GET, o servidor retorna uma solicitação HTTP 200 OK. e um feed contendo os contatos compartilhados do domínio que foram criada ou atualizada após a data especificada.
O feed não retorna mais de 10 MB em uma única resposta. Para obter a lista de contatos inteira com os critérios especificados, repetidamente siga o link Próxima do feed retornado até que ele não apareça mais no feed de retorno.

Rastrear alterações incrementais

Para controlar alterações incrementais em uma lista de contatos compartilhados no domínio, faça o seguintes: 1: Ao enviar uma solicitação de feed, acompanhe o valor do elemento <updated> do feed. 1. Só é possível acessar os contatos compartilhados do domínio que mudaram desde então a solicitação anterior definindo o parâmetro de consulta updated-min a esse valor de <updated>. showdeleted para true.

Receber um único contato compartilhado

Para ter apenas um contato compartilhado, você precisa usar o self link do contato. Você pode obter apenas o link próprio do contato compartilhado localizando a entrada do contato na feed de contatos compartilhados. Se você não souber qual valor usar para o self link, consulte Receber todos os contatos e Recupere contatos usando parâmetros de consulta.

Para acessar um contato compartilhado específico do domínio, envie um GET HTTP solicitação para o self link de um contato:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK>
```
Substitua o seguinte:

DOMAIN: o URL do seu domínio, por exemplo, exemplo.com.
PROJECTION: o valor de projeção que especifica o Elementos gd:extendedProperty. Para uma lista de valores compatíveis, consulte Valores de projeção.
SELF_LINK: um valor numérico único que representa uma único contato compartilhado, por exemplo, 12345.

Em seguida, o servidor retorna um código de status HTTP 200 OK e uma entrada que contém a contato

Por exemplo, para receber um contato compartilhado do domínio com o link próprio definido como https://www.google.com/m8/feeds/contacts/example.com/full/12345, envie o seguinte solicitação HTTP:

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

Próximas etapas

Criar a foto de um contato compartilhado