Actualizar la foto de un contacto compartido es ligeramente diferente a actualizar 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 uses vínculos de fotos, debes especificar el token de autorización en el encabezado HTTP. Para obtener más información, consulta Obtén más información sobre la autenticación y la autorización.
Cómo actualizar la foto de un contacto compartido
Todos los contactos compartidos tienen un elemento de vínculo de foto. El elemento de vínculo de foto aparece sin importar si el contacto tiene 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, entonces no hay ningún 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 la 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 datos de Google.