Crea contatti condivisi

Dopo aver configurato l'autenticazione, utilizza l'API Domain Shared Contacts per pubblicare nuove voci di contatti condivisi in un dominio Google Workspace. La visualizzazione dei contatti condivisi nel completamento automatico e nel gestore dei contatti può richiedere fino a 24 ore.

1. Crea una rappresentazione XML del contatto condiviso da pubblicare come elemento Atom <entry> del tipo di contatto:

   <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: Il nome del contatto, ad esempio Dana.
   • LAST_NAME: Il cognome del contatto, ad esempio A.
   • PRIMARY_EMAIL_ADDRESS: indirizzo email preferito, ad esempio [e-mail].
   • PREFERRED_NAME: il nome visualizzato dell'utente, ad esempio Dana A.
   • SECONDARY_EMAIL_ADDRESS: email secondaria, ad esempio [e-mail].
   • PRIMARY_PHONE_NUMBER: numero di telefono preferito, ad esempio 800-555-0100.
   • SECONDARY_PHONE_NUMBER: Numero di telefono secondario, ad esempio 800-555-0101.
   • INSTANT_MESSAGING_ADDRESS: l'indirizzo email di messaggistica istantanea, ad esempio [e-mail].
   • CITY_NAME: Nome della città, ad esempio Mountain View.
   • ADDRESS: indirizzo stradale, ad esempio 1800 Amphibious Blvd.
   • REGION_NAME: stato o provincia, ad esempio CA.
   • POST_CODE: codice postale, ad esempio 94045.
   • COUNTRY_NAME: Paese, ad esempio Stati Uniti.
   • FORMATTED_ADDRESS: Indirizzo formattato utilizzando le convenzioni locali, ad esempio 1800 Amphibious Blvd. Mountain View, CA 94045, USA.

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

   1. Inserisci l'elemento Atom <entry> 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 all'elenco example.com, invia la richiesta POST al seguente URL:

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

   Il server crea il contatto e restituisce un codice di stato HTTP 201 CREATED, insieme alla nuova voce di contatto. La voce restituita include elementi generati dal server, come <id>.

   Se la richiesta non riesce, il server restituisce un codice di stato diverso. Consulta il riferimento al protocollo dell'API Google Data.

Passaggi successivi

• Aggiornare o eliminare una foto per un contatto condiviso