Atualizar ou excluir um contato compartilhado

Atualizar e excluir um contato compartilhado são processos semelhantes porque ambos usam o URL de edição do contato.

Atualizar um contato compartilhado

Ao atualizar uma entrada, preserve todo o XML recuperado do servidor. Caso contrário, os elementos ignorados serão excluídos. As atualizações podem levar até 24 horas para aparecer no preenchimento automático e no gerenciador de contatos.

Para atualizar um contato compartilhado:

  1. Receba a entrada para atualizar.
  2. Edite a entrada.
  3. Envie uma solicitação PUT com a entrada atualizada para o URL de edição do contato. Use o tipo de conteúdo application/atom+xml e verifique se o valor <id> corresponde exatamente à entrada atual. O URL de edição termina com um número de versão para detectar conflitos. 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: seu domínio, por exemplo, example.com.
    • TITLE_NAME: um nome para a entrada, por exemplo, lista de contatos de exemplo.com.
    • FIRST_NAME: o nome do contato.
    • LAST_NAME: sobrenome do contato.
    • PROJECTION: o valor da projeção. Para valores compatíveis, consulte Valores de projeção.
    • PRIMARY_PHONE_NUMBER: número de telefone preferido.
    • CUSTOM_PROPERTY: nome de uma propriedade personalizada.
    • CUSTOM_PROPRTY_VALUE: valor de uma propriedade personalizada.

      Exemplo de entrada atualizada com o URL de edição em destaque:

      <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 excluídos podem levar até 24 horas para desaparecer do preenchimento automático e do gerenciador de contatos. Não atualize os contatos excluindo e adicionando-os novamente. Em vez disso, consulte Atualizar contatos.

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

O Google retém marcadores de posição para contatos excluídos por 30 dias. Use o parâmetro de consulta showdeleted para solicitá-los.

Próximas etapas

Atualizar ou excluir uma foto de um contato compartilhado