L'aggiornamento di una foto per un contatto condiviso è leggermente diverso dall'aggiornamento delle informazioni di un contatto condiviso. Per informazioni su come utilizzare le informazioni di un contatto condiviso, vedi Aggiornare o eliminare un contatto condiviso. Quando utilizzi i link alle foto, devi specificare il token di autorizzazione nell'intestazione HTTP. Per saperne di più, consulta Informazioni su autenticazione e autorizzazione.
Aggiornare una foto per un contatto condiviso
Ogni contatto condiviso ha un elemento di collegamento alla foto. L'elemento Link foto viene visualizzato
indipendentemente dal fatto che il contatto abbia o meno una foto associata. Se il contatto ha una foto, l'elemento contiene un attributo gd:etag che specifica un'intestazione HTTP ETag per la foto. Un ETag ti 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 una foto, non è presente l'attributo gd:etag e
l'attributo href fornisce l'URL da utilizzare per aggiungere una
foto al contatto.
Per aggiungere o aggiornare una foto, invia una nuova foto:
PUT https://www.google.com/m8/feeds/photos/media/USER_ID%40DOMAIN/PHOTO_LINKSostituisci quanto segue:
USER_ID: Il nome utente dell'utente, ad esempio Alex.DOMAIN: l'URL del tuo dominio, ad esempio example.com.PHOTO_LINK: un valore numerico univoco che rappresenta il link della foto per il contatto condiviso, ad esempio c9012de.
Di seguito è riportato un esempio di elemento di collegamento alla foto:
<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">
Eliminare una foto per un contatto condiviso
Per eliminare una foto, devi utilizzare il metodo DELETE HTTP.
Quando aggiorni o elimini una foto, invia il relativo ETag nell'intestazione If-Match della richiesta HTTP. Se non hai l'ultima versione della foto,
utilizza If-Match: * per ignorare il sistema di controllo delle versioni ed eliminare la foto.
Per maggiori informazioni su ETags, consulta il
riferimento al protocollo delle API Google Data.