Atualizar ou excluir a foto de um contato compartilhado

A atualização de uma foto para um contato compartilhado é um pouco diferente da atualização das 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, é necessário especificar o token de autorização no cabeçalho HTTP. Para mais informações, consulte Saiba mais sobre autenticação e autorização.

Atualizar uma foto para um contato compartilhado

Cada contato compartilhado tem um elemento de link de foto. O elemento de link de foto aparece se o contato tem uma foto associada ou não. Se o contato tiver uma foto, o elemento vai 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. 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 foto:

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

    Substitua:

    • USER_ID: o nome de usuário do usuário, por exemplo, Alex.
    • DOMAIN: o URL do seu domínio, por exemplo, example.com.
    • PHOTO_LINK: um valor numérico exclusivo que representa o link da foto para o 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/Alex%40example.com/c9012de">

Excluir uma foto para um contato compartilhado

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

Ao atualizar ou excluir uma foto, envie o ETag da foto 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 de dados do Google.