Crea contatti condivisi

Dopo il giorno configurare l'autenticazione, puoi utilizzare l'API dei contatti condivisi del dominio per pubblicare nuove voci di contatti condivisi in un dominio Google Workspace. Per i contatti condivisi possono essere necessarie fino a 24 ore vengono visualizzati nel completamento automatico dell'indirizzo email e in Gestione contatti.

  1. Crea una rappresentazione XML del contatto condiviso che vuoi vengono pubblicati sotto forma di elemento Atom <entry> dei Tipo di contatto, che potrebbe avere un aspetto simile al 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 per esempio, Alessandro.
    • LAST_NAME: il cognome del condiviso contatti, ad esempio Kim.
    • PRIMARY_EMAIL_ADDRESS: l'indirizzo email preferito indirizzo del contatto condiviso, ad esempio alk@gmail.com.
    • 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 alk@example.org.
    • PRIMARY_PHONE_NUMBER: il numero di telefono preferito per il contatto condiviso, ad esempio (800) 555-0100.
    • SECONDARY_PHONE_NUMBER: un altro numero di telefono per il contatto condiviso, ad esempio (800) 555-0101.
    • INSTANT_MESSAGING_ADDRESS: l'indirizzo email associate alle informazioni di messaggistica immediata del contatto condiviso, per ad esempio alk@gmail.com.
    • CITY_NAME: il nome della città per l'elemento condiviso contatto, ad esempio Mountain View.
    • ADDRESS: la via dell'elemento condiviso contatto, ad esempio 1600 Amphibious Blvd.
    • REGION_NAME: lo stato o la provincia per contatto condiviso, ad esempio CA.
    • POST_CODE: il CAP o il codice postale dell'elemento condiviso contatto, ad esempio 94045.
    • COUNTRY_NAME: il paese per la condivisione contatto, ad esempio Stati Uniti.
    • FORMATTED_ADDRESS: l'indirizzo del dispositivo condiviso contatto formattato utilizzando la convenzione del paese o regione,ad esempio 1800 Amphibious Blvd Mountain View.

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

    1. Posiziona il tuo elemento Atom <entry> nel corpo di un nuovo POST usando 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 indirizzo: URL:

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

    Il server di Google crea un contatto utilizzando la voce che hai inviato, quindi 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 quella che hai inviato, ma contiene anche vari elementi aggiunti server, ad esempio un elemento <id>.

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

Passaggi successivi