Créer des contacts partagés

Après avoir configuré l'authentification, vous pouvez utiliser l'API Domain Shared Contacts pour publier de nouvelles entrées de contacts partagés dans un domaine Google Workspace. L'affichage des contacts partagés dans la saisie semi-automatique des adresses e-mail et dans le gestionnaire de contacts peut prendre jusqu'à 24 heures.

  1. Créez une représentation XML du contact partagé que vous souhaitez publier sous la forme d'un élément Atom <entry> du genre Contact, qui peut se présenter comme suit:

    <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>

    Remplacez les éléments suivants :

    • FIRST_NAME: prénom du contact partagé, par exemple Alex.
    • LAST_NAME: nom du contact partagé (par exemple, Kim).
    • PRIMARY_EMAIL_ADDRESS: adresse e-mail préférée du contact partagé (par exemple, alk@gmail.com).
    • PREFERRED_NAME: nom affiché pour l'utilisateur (par exemple, Alex Kim)
    • SECONDARY_EMAIL_ADDRESS: autre adresse e-mail du contact partagé, par exemple alk@example.org.
    • PRIMARY_PHONE_NUMBER: numéro de téléphone préféré du contact partagé (par exemple, (800) 555-0100).
    • SECONDARY_PHONE_NUMBER: autre numéro de téléphone du contact partagé, par exemple (800) 555-0101.
    • INSTANT_MESSAGING_ADDRESS: adresse e-mail associée aux informations de messagerie instantanée du contact partagé (par exemple, alk@gmail.com).
    • CITY_NAME: nom de la ville du contact partagé (par exemple, Mountain View).
    • ADDRESS: adresse postale du contact partagé (par exemple, 1600 Amphibious Blvd)
    • REGION_NAME: État ou province du contact partagé, par exemple CA.
    • POST_CODE: code postal du contact partagé (par exemple, 94045).
    • COUNTRY_NAME: pays du contact partagé (par exemple, États-Unis).
    • FORMATTED_ADDRESS: adresse du contact partagé mise en forme selon la convention de son pays ou de sa région (par exemple, 1800 Amphibious Blvd, Mountain View).

  2. Pour publier cette entrée, envoyez-la à l'URL du flux de liste de contacts:

    1. Placez votre élément Atom <entry> dans le corps d'une nouvelle requête POST à l'aide du type de contenu application/atom+xml.
    2. Envoyez la requête POST à l'URL du flux.

    Par exemple, pour ajouter un contact partagé au domaine à la liste appartenant à example.com, envoyez la requête POST avec la nouvelle entrée à l'URL suivante:

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

    Le serveur Google crée un contact à l'aide de l'entrée que vous avez envoyée, puis renvoie un code d'état HTTP 201 CREATED, ainsi qu'une copie du nouveau contact sous la forme d'un élément <entry>. L'entrée renvoyée est la même que celle que vous avez envoyée, mais elle contient également divers éléments ajoutés par le serveur, tels qu'un élément <id>.

    Si votre requête échoue, Google peut renvoyer un code d'état différent. Pour en savoir plus sur les codes d'état, consultez la documentation de référence du protocole de l'API Google Data.

Étapes suivantes