Aggiornare o eliminare una foto per un contatto condiviso

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_LINK

    Sostituisci 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.