Atualizar a foto de um contato compartilhado é um pouco diferente da atualização das informações de um contato compartilhado. Saiba como trabalhar com as informações de um contato compartilhado em Atualizar ou excluir um contato compartilhado. Ao usar links de foto, você precisa especificar 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 da foto. O elemento do link da foto aparece
mesmo se o contato não tem 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 se referir 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 foto, não haverá atributo gd:etag
, e o atributo href
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/liz%40DOMAIN/PHOTO_LINK
Substitua:
DOMAIN
: o URL do 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.
Este é um exemplo de um 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 a foto de um contato compartilhado
Para excluir uma foto, você precisa usar 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 modificar o sistema de controle de versões e excluir a foto.
Para mais informações sobre ETags
, consulte a referência do protocolo das APIs de dados do Google.