Atualizar ou excluir um contato compartilhado

Os processos para atualizar ou excluir um contato compartilhado são semelhantes.

Atualizar um contato compartilhado

Ao atualizar uma entrada, é necessário preservar todo o XML que estava presente quando você recuperou a entrada do servidor. Caso contrário, os elementos ignorados serão excluídos. As atualizações podem levar até 24 horas para serem refletidas no preenchimento automático do endereço de e-mail e no gerenciador de contatos.

Para atualizar um contato compartilhado existente, faça o seguinte:

1. Acesse a entrada que você quer atualizar.
2. Edite a entrada.

3. Envie uma solicitação PUT com a entrada atualizada no corpo da mensagem para o URL de edição do contato. Use o tipo de conteúdo application/atom+xml e verifique se o valor <id> na entrada atualizada corresponde exatamente ao <id> da entrada existente. O URL de edição termina com um número de versão para detectar conflitos de atualizações de fontes diferentes. Para mais informações, consulte controle de versões.

   Atualize a entrada:

   <entry>
     <id>https://www.google.com/m8/feeds/contacts/DOMAIN/base/8411573</id>
     <updated>2008-02-28T18:47:02.303Z</updated>
     <category scheme='http://schemas.google.com/g/2005#kind'
       term='http://schemas.google.com/contact/2008#contact' />
     <title type='text'>TITLE_NAME</title>
     <gd:name>
       <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName>
     </gd:name>
     <content type='text'>NOTES</content>
     <link rel='self' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573' />
     <link rel='edit' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573/1204224422303000' />
     <gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
       primary='true'>PRIMARY_PHONE_NUMBER</gd:phoneNumber>
     <gd:extendedProperty name="CUSTOM_PROPERTY" value="CUSTOM_PROPRTY_VALUE" />
   </entry>
   

   Substitua:

   • DOMAIN: o URL do domínio, por exemplo, example.com.
   • TITLE_NAME: um nome para a entrada do contato, por exemplo, example.com lista de contatos.
   • FIRST_NAME: o nome do contato compartilhado. Por exemplo, Alex.
   • LAST_NAME: o sobrenome do contato compartilhado. Por exemplo, Kim.
   • PROJECTION: o valor de projeção que especifica os elementos gd:extendedProperty. Para conferir uma lista de valores compatíveis, consulte Valores de projeção.
   • PRIMARY_PHONE_NUMBER: o número de telefone preferencial do contato compartilhado, por exemplo, [phone].
   • CUSTOM_PROPERTY: um nome para uma propriedade personalizada que você quer armazenar sobre o contato compartilhado, por exemplo, animal de estimação.

   • CUSTOM_PROPRTY_VALUE: um valor de uma propriedade personalizada que você quer armazenar sobre o contato compartilhado, por exemplo, hamster.

     Este é um exemplo de entrada atualizada de um contato compartilhado com o URL de edição destacado:

     <entry>
     <id>https://www.google.com/m8/feeds/contacts/example.com/base/8411573</id>
     <updated>2008-02-28T18:47:02.303Z</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>
     <content type='text'>Notes</content>
     <link rel='self' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573' />
     <link rel='edit' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573/1204224422303000' />
     <gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
       primary='true'>456-123-2133</gd:phoneNumber>
     <gd:extendedProperty name="pet" value="hamster" />
     <gd:extendedProperty name="cuisine">
       <italian />
     </gd:extendedProperty>
     </entry>
     

Excluir contatos compartilhados

Os contatos compartilhados excluídos podem levar até 24 horas para desaparecer do preenchimento automático do endereço de e-mail e do gerenciador de contatos. Para atualizar os contatos existentes, consulte Como atualizar contatos. Não atualize contatos excluindo e adicionando novamente contatos.

• Para excluir um contato compartilhado, envie uma solicitação DELETE ao URL de edição do contato. Esse é o mesmo URL usado para atualizar contatos.

O Google retém marcadores de posição para contatos excluídos por 30 dias após a exclusão. Durante esse tempo, é possível solicitar os marcadores usando o parâmetro de consulta showdeleted.

Próximas etapas

Atualizar ou excluir a foto de um contato compartilhado