Atualizar ou excluir a foto de um contato compartilhado

Atualizar uma foto de um contato compartilhado é um pouco diferente de atualizar as informações de um contato compartilhado. Para informações sobre como trabalhar com as informações de um contato compartilhado, consulte Atualizar ou excluir um contato compartilhado. Ao usar links de fotos, especifique o token de autorização no cabeçalho HTTP. Para mais informações, consulte Saiba mais sobre autenticação e autorização.

Atualizar a foto de um contato compartilhado

Cada contato compartilhado tem um elemento de link de foto. O elemento de link de foto aparece mesmo que o contato não tenha uma foto associada. Se o contato tiver uma foto, o elemento conterá um atributo gd:etag que especifica um cabeçalho HTTP ETag para a foto. Um ETag permite que você se refira a uma versão específica de uma entrada específica. Nesse caso, ele permite que você se refira a uma versão específica de uma foto. Se o contato não tiver uma foto, não haverá um atributo gd:etag, e o atributo href vai fornecer o URL a ser usado para adicionar uma foto ao contato.

  • Para adicionar ou atualizar uma foto, envie uma nova:

    PUT https://www.google.com/m8/feeds/photos/media/liz%40DOMAIN/PHOTO_LINK

    Substitua:

    • DOMAIN: o URL do seu domínio, por exemplo, example.com.
    • PHOTO_LINK: um valor numérico exclusivo que representa o link da foto do contato compartilhado, por exemplo, c9012de.

    Confira a seguir um exemplo de elemento de link de foto:

    <link rel="http://schemas.google.com/contacts/2008/rel#photo"
    type="image/*" href="https://www.google.com/m8/feeds/photos/media/liz%40example.com/c9012de">
    

Excluir uma foto de um contato compartilhado

Para excluir uma foto, use o método HTTP DELETE.

Ao atualizar ou excluir uma foto, envie o ETag dela no cabeçalho If-Match da solicitação HTTP. Se você não tiver a versão mais recente da foto, use If-Match: * para substituir o sistema de controle de versão e excluir a foto.

Para mais informações sobre ETags, consulte a referência do protocolo das APIs Data do Google.