La mise à jour d'une photo pour un contact partagé est légèrement différente de la mise à jour des informations d'un contact partagé. Pour en savoir plus sur l'utilisation des informations d'un contact partagé, consultez la section Modifier 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é comporte un élément de lien photo. L'élément de lien vers la photo s'affiche, que le contact ait une photo associée ou non. Si le contact possède 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, et 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_LINKRemplacez les éléments suivants :
DOMAIN: URL de votre domaine (par exemple, example.com).PHOTO_LINK: valeur numérique unique représentant le lien vers 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 une photo d'un contact partagé
Pour supprimer une photo, vous devez utiliser la méthode HTTP DELETE.
Lorsque vous mettez à jour ou supprimez une photo, envoyez le 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 en savoir plus sur ETags, consultez la documentation de référence sur le protocole des API Google Data.