Aggiornare o eliminare un contatto condiviso

Le procedure per aggiornare o eliminare un contatto condiviso sono simili.

Aggiornare un contatto condiviso

Quando aggiorni una voce, devi conservare tutto il codice XML presente quando hai recuperato la voce dal server. In caso contrario, gli elementi ignorati vengono eliminati. Possono trascorrere fino a 24 ore prima che gli aggiornamenti siano visibili nel completamento automatico dell'indirizzo email e nel gestore dei contatti.

Per aggiornare un contatto condiviso esistente:

1. Richiedi la voce che vuoi aggiornare.
2. Modifica la voce.

3. Invia una richiesta PUT con la voce aggiornata nel corpo del messaggio all'URL di modifica del contatto. Utilizza il tipo di contenuti application/atom+xml e assicurati che il valore <id> nella voce aggiornata corrisponda esattamente al valore <id> della voce esistente. L'URL di modifica termina con un numero di versione per rilevare i conflitti degli aggiornamenti provenienti da fonti diverse. Per ulteriori informazioni, consulta la sezione Controllo delle versioni.

   Aggiorna la voce:

   <entry>
     <id>https://www.google.com/m8/feeds/contacts/DOMAIN/base/8411573</id>
     <updated>2008-02-28T18:47:02.303Z</updated>
     <category scheme='http://schemas.google.com/g/2005#kind'
       term='http://schemas.google.com/contact/2008#contact' />
     <title type='text'>TITLE_NAME</title>
     <gd:name>
       <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName>
     </gd:name>
     <content type='text'>NOTES</content>
     <link rel='self' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573' />
     <link rel='edit' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573/1204224422303000' />
     <gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
       primary='true'>PRIMARY_PHONE_NUMBER</gd:phoneNumber>
     <gd:extendedProperty name="CUSTOM_PROPERTY" value="CUSTOM_PROPRTY_VALUE" />
   </entry>

   Sostituisci quanto segue:

   • DOMAIN: l'URL del tuo dominio, ad esempio example.com.
   • TITLE_NAME: un nome per la voce del contatto, ad esempio elenco contatti example.com.
   • FIRST_NAME: il nome del contatto condiviso, ad esempio Alex.
   • LAST_NAME: il cognome del contatto condiviso, ad esempio Kim.
   • PROJECTION: il valore di proiezione che specifica gli elementi gd:extendedProperty. Per un elenco dei valori supportati, consulta Valori di proiezione.
   • PRIMARY_PHONE_NUMBER: il numero di telefono preferito per il contatto condiviso, ad esempio [phone].
   • CUSTOM_PROPERTY: un nome per una proprietà personalizzata che vuoi memorizzare in merito al contatto condiviso, ad esempio animale domestico.

   • CUSTOM_PROPRTY_VALUE: un valore per una proprietà personalizzata che vuoi memorizzare in merito al contatto condiviso, ad esempio topo.

     Di seguito è riportato un esempio di voce aggiornata per un contatto condiviso con l'URL di modifica evidenziato:

     <entry>
     <id>https://www.google.com/m8/feeds/contacts/example.com/base/8411573</id>
     <updated>2008-02-28T18:47:02.303Z</updated>
     <category scheme='http://schemas.google.com/g/2005#kind'
       term='http://schemas.google.com/contact/2008#contact' />
     <title type='text'>Fitzgerald</title>
     <gd:name>
       <gd:fullName>Fitzgerald</gd:fullName>
     </gd:name>
     <content type='text'>Notes</content>
     <link rel='self' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573' />
     <link rel='edit' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573/1204224422303000' />
     <gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
       primary='true'>456-123-2133</gd:phoneNumber>
     <gd:extendedProperty name="pet" value="hamster" />
     <gd:extendedProperty name="cuisine">
       <italian />
     </gd:extendedProperty>
     </entry>

Eliminare i contatti condivisi

Possono essere necessarie fino a 24 ore prima che i contatti condivisi eliminati scompaiano dal completamento automatico dell'indirizzo email e dal gestore dei contatti. Per aggiornare i contatti esistenti, consulta Aggiornare i contatti. Non aggiornare i contatti eliminandoli e aggiungendoli di nuovo.

• Per eliminare un contatto condiviso, invia una richiesta DELETE all'URL di modifica del contatto. Si tratta dello stesso URL utilizzato per aggiornare i contatti.

Google conserva i segnaposto per i contatti eliminati per 30 giorni dopo l'eliminazione. Durante questo periodo, puoi richiedere i segnaposto utilizzando il parametro di query showdeleted.

Passaggi successivi

Aggiornare o eliminare una foto di un contatto condiviso