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 contact partagées dans un domaine Google Workspace. Il peut s'écouler jusqu'à 24 heures avant que les contacts partagés ne s'affichent dans la saisie semi-automatique des adresses e-mail et dans le gestionnaire de contacts.

  1. Créez une représentation XML du contact partagé que vous souhaitez publier sous la forme d'un élément Atom <entry> du type de contact, qui peut ressembler à ceci:

    <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 de famille 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é pour le 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 les conventions 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 <entry> Atom 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é de 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 le document de référence sur le protocole de l'API Google Data.

Étapes suivantes