Aggiornare o eliminare un contatto condiviso

I processi per aggiornare o eliminare un contatto condiviso sono simili.

Aggiornare un contatto condiviso

Quando aggiorni una voce, devi conservare tutto il codice XML presente nel momento in cui hai recuperato la voce dal server. In caso contrario, gli elementi ignorati vengono eliminati. Possono essere necessarie fino a 24 ore prima che gli aggiornamenti siano visibili nell'indirizzo email il completamento automatico e il programma di gestione dei contatti.

Per aggiornare un contatto condiviso esistente:

1. Ottieni la voce da aggiornare.
2. Modifica la voce.

3. Invia una richiesta PUT con la voce aggiornata nel corpo del messaggio all'indirizzo l'URL di modifica del contatto. Usa il tipo di contenuti application/atom+xml e aumenta assicurati che il valore <id> nella voce aggiornata corrisponda esattamente a <id> della voce esistente. L'URL di modifica termina con un numero di versione, per rilevare conflitti di aggiornamenti da fonti diverse. Per ulteriori informazioni, vedi il 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, per esempio: elenco contatti example.com.
   • FIRST_NAME: il nome del condiviso contatto, ad esempio Alex.
   • LAST_NAME: il cognome del condiviso contatti, ad esempio Kim.
   • PROJECTION: il valore della proiezione specifica gli elementi gd:extendedProperty. Per un elenco delle i valori, consulta Valori di proiezione.
   • PRIMARY_PHONE_NUMBER: lo smartphone preferito numero del contatto condiviso, ad esempio [phone].
   • CUSTOM_PROPERTY: il nome di una proprietà personalizzata che vuoi memorizzare sul contatto condiviso, ad esempio pet.

   • CUSTOM_PROPRTY_VALUE: un valore per un che vuoi archiviare per il contatto condiviso, ad esempio criceto.

     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

Può essere necessario attendere fino a 24 ore prima che i contatti condivisi eliminati non siano più presenti nell'email il completamento automatico degli indirizzi e il gestore contatti. Per aggiornare i contatti esistenti, vedi Aggiornare i contatti. Non aggiornare i contatti eliminandoli e aggiungendoli di nuovo.

• Per eliminare un contatto condiviso, invia una richiesta DELETE al suo modifica URL. Questo è lo 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 l'showdeleted parametro di query.

Passaggi successivi

Aggiornare o eliminare una foto per un contatto condiviso