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, você precisa preservar todo o XML que estava presente quando você extraiu a entrada do servidor. Caso contrário, os elementos ignorados são excluídos. As atualizações podem levar até 24 horas para serem exibidas no preenchimento automático do endereço de e-mail e no gerenciador de contatos.

Para atualizar um contato compartilhado, 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 atual. O URL de edição termina com um número de versão para detectar conflitos de atualizações de diferentes origens. 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 seu domínio, por exemplo, example.com.
   • TITLE_NAME: um nome para a entrada de contato, por exemplo, lista de contatos de example.com.
   • 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, "pet".

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

     Confira a seguir 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

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

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

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

Próximas etapas

Atualizar ou excluir uma foto de um contato compartilhado