Crea contatti condivisi

Dopo aver configurato l'autenticazione, puoi utilizzare l'API Domain Shared Contacts per pubblicare nuove voci di contatto condivisi in un dominio Google Workspace. Possono trascorrere fino a 24 ore prima che i contatti condivisi vengano visualizzati nel completamento automatico dell'indirizzo email e nel gestore dei contatti.

  1. Crea una rappresentazione XML del contatto condiviso che vuoi pubblicare sotto forma di elemento Atom <entry> del tipo di contatto, che potrebbe essere 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: il 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 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 associato alle informazioni di messaggistica istantanea del contatto condiviso, ad esempio alk@gmail.com.
    • 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 utilizzando le convenzioni del paese o della regione,ad esempio 1800 Amphibious Blvd Mountain View.

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

    1. Inserisci l'elemento Atom <entry> nel corpo di una nuova richiesta POST utilizzando il tipo di contenuto 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 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 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 stato diverso. Per informazioni sui codici di stato, consulta il documento di riferimento del protocollo dell'API Google Data.

Passaggi successivi