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.