Aggiornare o eliminare un contatto condiviso

L'aggiornamento e l'eliminazione di un contatto condiviso sono simili perché entrambi utilizzano l'URL di modifica del contatto.

Aggiorna un contatto condiviso

Quando aggiorni una voce, conserva tutto l'XML recuperato dal server. In caso contrario, gli elementi ignorati vengono eliminati. L'aggiornamento può richiedere fino a 24 ore per essere visualizzato nel completamento automatico e nel gestore dei contatti.

Per aggiornare un contatto condiviso esistente:

  1. Recupera la voce da aggiornare.
  2. Modifica la voce.
  3. Invia una richiesta PUT con la voce aggiornata all'URL di modifica del contatto. Utilizza il tipo di contenuti application/atom+xml e assicurati che il valore <id> 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 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: 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, vedi Valori di proiezione.
    • PRIMARY_PHONE_NUMBER: Numero di telefono preferito.
    • CUSTOM_PROPERTY: il nome di una proprietà personalizzata.
    • CUSTOM_PROPRTY_VALUE: 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 dal completamento automatico e dal programma di gestione dei contatti. Non aggiornare i contatti eliminandoli e aggiungendoli di nuovo. Consulta invece Aggiornare i contatti.

  • 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. Utilizza il parametro di query showdeleted per richiederli.

Passaggi successivi

Aggiornare o eliminare una foto per un contatto condiviso