Aggiornare una foto per un contatto condiviso è leggermente diverso dall'aggiornamento delle informazioni di un contatto condiviso. Per informazioni sull'utilizzo delle informazioni di un contatto condiviso, consulta Aggiornare o eliminare un contatto condiviso. Quando utilizzi i link di foto, devi specificare il token di autorizzazione nell'intestazione HTTP. Per maggiori informazioni, consulta Informazioni su autenticazione e autorizzazione.
Aggiornare una foto per un contatto condiviso
Ogni contatto condiviso ha un elemento link foto. L'elemento link foto viene visualizzato
a prescindere dal fatto che il contatto sia associato o meno a una foto. Se il contatto ha una foto, l'elemento contiene un attributo gd:etag che specifica un'intestazione HTTP ETag per la foto. Un ETag consente di fare riferimento a una versione specifica di una determinata voce. In questo caso, ti consente di fare riferimento a una versione specifica di una foto. Se il contatto non ha foto, non esiste un attributo gd:etag e l'attributo href fornisce l'URL da utilizzare per aggiungere una foto al contatto.
Per aggiungere o aggiornare una foto, inviane una nuova:
PUT https://www.google.com/m8/feeds/photos/media/liz%40DOMAIN/PHOTO_LINK
Sostituisci quanto segue:
DOMAIN: l'URL del tuo dominio, ad esempio example.com.PHOTO_LINK: un valore numerico univoco che rappresenta il link della foto del contatto condiviso, ad esempio c9012de.
Di seguito è riportato un esempio di elemento link 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">
Eliminare una foto per un contatto condiviso
Per eliminare una foto, devi utilizzare il metodo HTTP DELETE.
Quando aggiorni o elimini una foto, invia il relativo ETag nell'intestazione If-Match della richiesta HTTP. Se non hai la versione più recente della foto, utilizza If-Match: * per eseguire l'override del sistema di controllo delle versioni ed eliminare la foto.
Per ulteriori informazioni su ETags, consulta la
documentazione di riferimento sul protocollo delle API di dati di Google.