La actualización de una foto de un contacto compartido es un poco diferente a la actualización de la información de un contacto compartido. Para obtener información sobre cómo trabajar con la información de un contacto compartido, consulta Cómo actualizar o borrar un contacto compartido. Cuando usas vínculos de fotos, debes especificar el token de autorización en el encabezado HTTP. Para obtener más información, consulta Más información sobre la autenticación y la autorización.
Cómo actualizar una foto de un contacto compartido
Cada contacto compartido tiene un elemento de vínculo de foto. El elemento de vínculo de foto aparece, ya sea que el contacto tenga una foto asociada o no. Si el contacto tiene una foto, el elemento contiene un atributo gd:etag
que especifica un encabezado HTTP ETag
para la foto. Un ETag
te permite hacer referencia a una versión específica de una entrada en particular. En este caso, te permite hacer referencia a una versión específica de una foto. Si el contacto no tiene una foto, no hay un atributo gd:etag
, y el atributo href
proporciona la URL que se debe usar para agregar una foto al contacto.
Para agregar o actualizar una foto, envía una nueva:
PUT https://www.google.com/m8/feeds/photos/media/liz%40DOMAIN/PHOTO_LINK
Reemplaza lo siguiente:
DOMAIN
: Es la URL de tu dominio, por ejemplo, example.com.PHOTO_LINK
: Es un valor numérico único que representa el vínculo de la foto del contacto compartido, por ejemplo, c9012de.
El siguiente es un ejemplo de un elemento de vínculo 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">
Cómo borrar una foto de un contacto compartido
Para borrar una foto, debes usar el método HTTP DELETE
.
Cuando actualices o borres una foto, envía el ETag
de la foto en el encabezado If-Match
de la solicitud HTTP. Si no tienes la versión más reciente de la foto, usa If-Match: *
para anular el sistema de control de versiones y borrar la foto.
Para obtener más información sobre ETags
, consulta la referencia del protocolo de las APIs de Google Data.