La procédure à suivre pour mettre à jour la photo d'un contact partagé est légèrement différente de celle des informations d'un contact partagé. Pour en savoir plus sur l'utilisation des informations d'un contact partagé, consultez la section Mettre à jour ou supprimer un contact partagé. Lorsque vous utilisez des liens photo, vous devez spécifier le jeton d'autorisation dans l'en-tête HTTP. Pour en savoir plus, consultez la section En savoir plus sur l'authentification et l'autorisation.
Modifier la photo d'un contact partagé
Chaque contact partagé possède un élément de lien photo. L'élément de lien photo s'affiche, que le contact soit associé ou non à une photo. Si le contact a une photo, l'élément contient un attribut gd:etag qui spécifie un en-tête HTTP ETag pour la photo. Un ETag vous permet de faire référence à une version spécifique d'une entrée particulière. Dans ce cas, il vous permet de faire référence à une version spécifique d'une photo. Si le contact n'a pas de photo, il n'y a pas d'attribut gd:etag. L'attribut href fournit l'URL à utiliser pour ajouter une photo au contact.
Pour ajouter ou mettre à jour une photo, envoyez-en une nouvelle:
PUT https://www.google.com/m8/feeds/photos/media/liz%40DOMAIN/PHOTO_LINK
Remplacez les éléments suivants :
DOMAIN: URL de votre domaine (par exemple, example.com).PHOTO_LINK: valeur numérique unique représentant le lien de la photo du contact partagé (par exemple, c9012de).
Voici un exemple d'élément de lien photo:
<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">
Supprimer la photo d'un contact partagé
Pour supprimer une photo, vous devez utiliser la méthode HTTP DELETE.
Lors de la mise à jour ou de la suppression d'une photo, envoyez la ETag de la photo dans l'en-tête If-Match de la requête HTTP. Si vous ne disposez pas de la dernière version de la photo, utilisez If-Match: * pour remplacer le système de gestion des versions et supprimer la photo.
Pour plus d'informations sur ETags, consultez la documentation de référence du protocole des API Google Data.