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:
- Acesse a entrada que você quer atualizar.
- Edite a entrada.
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údoapplication/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 elementosgd: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, (206)555-1212.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