Crea contatti condivisi

Dopo aver configurato l'autenticazione, puoi utilizzare l'API Domain Shared Contacts per pubblicare le nuove voci dei contatti condivisi in un dominio Google Workspace. La visualizzazione dei contatti condivisi nel completamento automatico dell'indirizzo email e in Gestione contatti può richiedere fino a 24 ore.

1. Crea una rappresentazione XML del contatto condiviso che vuoi pubblicare sotto forma di elemento <entry> Atom di Contact kind, che potrebbe essere simile alla seguente:

   <atom:entry xmlns:atom='http://www.w3.org/2005/Atom'
       xmlns:gd='http://schemas.google.com/g/2005'>
     <atom:category scheme='http://schemas.google.com/g/2005#kind'
       term='http://schemas.google.com/contact/2008#contact' />
     <gd:name>
        <gd:givenName>FIRST_NAME</gd:givenName>
        <gd:familyName>LAST_NAME</gd:familyName>
        <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName>
     </gd:name>
     <atom:content type='text'>NOTES</atom:content>
     <gd:email rel='http://schemas.google.com/g/2005#work'
       primary='true'
       address='PRIMARY_EMAIL_ADDRESS' displayName='PREFERRED_NAME' />
     <gd:email rel='http://schemas.google.com/g/2005#home'
       address='SECONDARY_EMAIL_ADDRESS' />
     <gd:phoneNumber rel='http://schemas.google.com/g/2005#work'
       primary='true'>
       PRIMARY_PHONE_NUMBER
     </gd:phoneNumber>
     <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'>
       SECONDARY_PHONE_NUMBER
     </gd:phoneNumber>
     <gd:im address='INSTANT_MESSAGING_ADDRESS'
       protocol='http://schemas.google.com/g/2005#GOOGLE_TALK'
       primary='true'
       rel='http://schemas.google.com/g/2005#home' />
     <gd:structuredPostalAddress
         rel='http://schemas.google.com/g/2005#work'
         primary='true'>
       <gd:city>CITY_NAME</gd:city>
       <gd:street>ADDRESS</gd:street>
       <gd:region>REGION_NAME</gd:region>
       <gd:postcode>POST_CODE</gd:postcode>
       <gd:country>COUNTRY_NAME</gd:country>
       <gd:formattedAddress>
         FORMATTED_ADDRESS
       </gd:formattedAddress>
     </gd:structuredPostalAddress>
   </atom:entry>
   

   Sostituisci quanto segue:

   • FIRST_NAME: nome del contatto condiviso, ad esempio Alex.
   • LAST_NAME: il cognome del contatto condiviso, ad esempio Kim.
   • PRIMARY_EMAIL_ADDRESS: l'indirizzo email preferito del contatto condiviso, ad esempio [e-mail].
   • PREFERRED_NAME: il nome visualizzato per l'utente, ad esempio Alex Kim
   • SECONDARY_EMAIL_ADDRESS: un altro indirizzo email per il contatto condiviso, ad esempio [e-mail].
   • PRIMARY_PHONE_NUMBER: il numero di telefono preferito per il contatto condiviso, ad esempio [phone].
   • SECONDARY_PHONE_NUMBER: un altro numero di telefono per il contatto condiviso, ad esempio [phone].
   • INSTANT_MESSAGING_ADDRESS: l'indirizzo email associato alle informazioni di messaggistica immediata del contatto condiviso, ad esempio [e-mail].
   • CITY_NAME: il nome della città del contatto condiviso, ad esempio Mountain View.
   • ADDRESS: l'indirizzo del contatto condiviso, ad esempio 1600 Amphibious Blvd.
   • REGION_NAME: lo stato o la provincia del contatto condiviso, ad esempio CA.
   • POST_CODE: il codice postale del contatto condiviso, ad esempio 94045.
   • COUNTRY_NAME: il paese del contatto condiviso, ad esempio Stati Uniti.
   • FORMATTED_ADDRESS: l'indirizzo del contatto condiviso formattato in base alla convenzione del paese o dell'area geografica,ad esempio 1800 Amphibious Blvd Mountain View.

2. Per pubblicare questa voce, inviala all'URL del feed elenco contatti:

   1. Inserisci l'elemento <entry> Atom nel corpo di una nuova richiesta POST utilizzando il tipo di contenuti application/atom+xml.
   2. Invia la richiesta POST all'URL del feed.

   Ad esempio, per aggiungere un contatto condiviso del dominio all'elenco appartenente a example.com, invia la richiesta POST con la nuova voce al seguente URL:

   https://www.google.com/m8/feeds/contacts/example.com/full
   

   Il server di Google crea un contatto utilizzando la voce che hai inviato, poi restituisce un codice di stato HTTP 201 CREATED, insieme a una copia del nuovo contatto sotto forma di elemento <entry>. La voce restituita è la stessa che hai inviato, ma contiene anche vari elementi aggiunti dal server, ad esempio un elemento <id>.

   Se la richiesta non va a buon fine, Google potrebbe restituire un codice di stato diverso. Per informazioni sui codici di stato, consulta il documento di riferimento sul protocollo dell'API di dati di Google.

Passaggi successivi

• Aggiornare o eliminare una foto di un contatto condiviso