L'aggiornamento e l'eliminazione di un contatto condiviso sono simili perché entrambi utilizzano l'URL di modifica del contatto.
Aggiornare un contatto condiviso
Quando aggiorni una voce, conserva tutto l'XML recuperato dal server. In caso contrario, gli elementi ignorati vengono eliminati. L'applicazione degli aggiornamenti può richiedere fino a 24 ore in autocompletamento e nel gestore dei contatti.
Per aggiornare un contatto condiviso esistente:
- Recupera la voce da aggiornare.
- Modifica la voce.
Invia una richiesta
PUTcon la voce aggiornata all'URL di modifica del contatto. Utilizza ilapplication/atom+xmltipo di contenuto e assicurati che il<id>valore corrisponda esattamente alla voce esistente. L'URL di modifica termina con un numero di versione per rilevare i conflitti. Per saperne di più, consulta la sezione relativa al controllo delle versioni. versioning.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: il tuo dominio, ad esempio example.com.TITLE_NAME: un nome per la voce, ad esempio elenco contatti example.com.FIRST_NAME: il nome del contatto.LAST_NAME: il cognome del contatto.PROJECTION: il valore della proiezione. Per i valori supportati, consulta Valori di proiezione.PRIMARY_PHONE_NUMBER: il numero di telefono preferito.CUSTOM_PROPERTY: il nome di una proprietà personalizzata.CUSTOM_PROPRTY_VALUE: il valore di una proprietà personalizzata.Esempio di voce aggiornata 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
L'eliminazione dei contatti può richiedere fino a 24 ore prima che scompaiano dall'autocompletamento e dal gestore dei contatti. Non aggiornare i contatti eliminandoli e aggiungendoli di nuovo. Consulta invece Aggiornare i contatti.
- Per eliminare un contatto condiviso, invia una richiesta
DELETEall'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. Utilizza il parametro di query showdeleted per richiederli.
Passaggi successivi
Aggiornare o eliminare una foto per un contatto condiviso