Modifier ou supprimer la photo d'un contact partagé

La procédure pour modifier la photo d'un contact partagé est légèrement différente de celle pour modifier les informations d'un contact partagé. Pour savoir comment utiliser les informations d'un contact partagé, consultez Modifier ou supprimer un contact partagé. Lorsque vous utilisez des liens vers des photos, vous devez spécifier le jeton d'autorisation dans l'en-tête HTTP. Pour en savoir plus, consultez À propos de l'authentification et de l'autorisation.

Modifier la photo d'un contact partagé

Chaque contact partagé comporte 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 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, l'attribut gd:etag n'existe pas et l'attribut href fournit l'URL à utiliser pour ajouter une photo au contact.

  • Pour ajouter ou modifier une photo, envoyez-en une nouvelle :

    PUT https://www.google.com/m8/feeds/photos/media/USER_ID%40DOMAIN/PHOTO_LINK

    Remplacez les éléments suivants :

    • USER_ID : nom d'utilisateur (par exemple, "Alex").
    • DOMAIN : URL de votre domaine (par exemple, example.com).
    • PHOTO_LINK : valeur numérique unique qui représente le lien 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/Alex%40example.com/c9012de">

Supprimer une photo pour un contact partagé

Pour supprimer une photo, vous devez utiliser la méthode HTTP DELETE.

Lorsque vous mettez à jour ou supprimez une photo, envoyez son ETag dans l'en-tête If-Match de la requête HTTP. Si vous n'avez pas 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 du protocole des API Google Data.