Créer des contacts partagés

Après avoir configuré l'authentification, utilisez l'API Domain Shared Contacts pour publier de nouvelles entrées de contacts partagés dans un domaine Google Workspace. Il peut s'écouler jusqu'à 24 heures avant que les contacts partagés s'affichent dans la saisie semi-automatique et le gestionnaire de contacts.

1. Créez une représentation XML du contact partagé à publier en tant qu'élément Atom <entry> du type de contact :

   <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, par exemple "Dana".
   • LAST_NAME : nom de famille du contact, par exemple "A.".
   • PRIMARY_EMAIL_ADDRESS : adresse e-mail préférée, par exemple [e-mail].
   • PREFERRED_NAME : nom à afficher pour l'utilisateur, par exemple "Dana A.".
   • SECONDARY_EMAIL_ADDRESS : adresse e-mail secondaire, par exemple [e-mail].
   • PRIMARY_PHONE_NUMBER : numéro de téléphone préféré, par exemple 800-555-0100.
   • SECONDARY_PHONE_NUMBER : numéro de téléphone secondaire, tel que 800-555-0101.
   • INSTANT_MESSAGING_ADDRESS : adresse e-mail de messagerie instantanée, par exemple [e-mail].
   • CITY_NAME : nom de la ville, par exemple "Mountain View".
   • ADDRESS : adresse postale, par exemple 1800 Amphibious Blvd.
   • REGION_NAME : État ou province, par exemple "CA".
   • POST_CODE : code postal, tel que 94045.
   • COUNTRY_NAME : pays, par exemple "États-Unis".
   • FORMATTED_ADDRESS : adresse formatée selon les conventions locales, par exemple 1800 Amphibious Blvd., Mountain View, CA 94045, États-Unis.

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

   1. Placez l'é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 à la liste example.com, envoyez la requête POST à l'URL suivante :

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

   Le serveur crée le contact et renvoie un code d'état HTTP 201 CREATED, ainsi que la nouvelle entrée de contact. L'entrée renvoyée inclut des éléments générés par le serveur, tels que <id>.

   Si la requête échoue, le serveur renvoie un code d'état différent. Consultez la documentation de référence sur le protocole Google Data API.

Étapes suivantes

• Modifier ou supprimer la photo d'un contact partagé