Obtenir les contacts partagés

Vous pouvez demander les contacts des utilisateurs partagés de différentes manières :

  • Tous les contacts partagés
  • Un ensemble de contacts correspondant à des critères spécifiés
  • Un seul contact partagé
  • Photo d'un contact

Par défaut, les entrées d'un flux ne sont pas ordonnées.

Obtenir tous les contacts partagés

  1. Pour obtenir tous les contacts partagés, envoyez une requête HTTP GET à l'URL du flux de contacts :

    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION

    Remplacez les éléments suivants :

    • DOMAIN : votre domaine. Par exemple, example.com.
    • PROJECTION : valeur de la projection. Pour connaître les valeurs acceptées, consultez Valeurs de projection.

    Le serveur renvoie un code d'état HTTP 200 OK et un flux Atom 1.0. L'exemple suivant montre un flux de contacts avec une entrée :

    <feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
    xmlns:gd='http://schemas.google.com/g/2005'
    xmlns:gContact='http://schemas.google.com/contact/2008'
    xmlns:batch='http://schemas.google.com/gdata/batch'>
  <id>https://www.google.com/m8/feeds/contacts/example.com/base</id>
  <updated>2008-03-05T12:36:38.836Z</updated>
  <category scheme='http://schemas.google.com/g/2005#kind'
    term='http://schemas.google.com/contact/2008#contact' />
  <title type='text'>example.com's Contacts</title>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full' />
  <link rel='http://schemas.google.com/g/2005#post'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full' />
  <link rel='http://schemas.google.com/g/2005#batch'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full/batch' />
  <link rel='self' type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full?max-results=25' />
  <author>
    <name>example.com</name>
    <email>example.com</email>
  </author>
  <generator version='1.0' uri='https://www.google.com/m8/feeds/contacts'>
    Contacts
  </generator>
  <openSearch:totalResults>1</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
  <entry>
    <id>
      https://www.google.com/m8/feeds/contacts/example.com/base/c9012de
    </id>
    <updated>2008-03-05T12:36:38.835Z</updated>
    <category scheme='http://schemas.google.com/g/2005#kind'
      term='http://schemas.google.com/contact/2008#contact' />
    <title type='text'>Fitzgerald</title>
    <gd:name>
      <gd:fullName>Fitzgerald</gd:fullName>
    </gd:name>
    <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*"
      href="http://google.com/m8/feeds/photos/media/example.com/c9012de"/>
    <link rel='self' type='application/atom+xml'
      href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de' />
    <link rel='edit' type='application/atom+xml'
      href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de/1204720598835000' />
    <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'
      primary='true'>
      456
    </gd:phoneNumber>
    <gd:extendedProperty name="pet" value="hamster" />
  </entry>
</feed>

  2. Les flux renvoient un maximum de 10 Mo dans une seule réponse. Pour obtenir la liste complète, cliquez plusieurs fois sur le lien Suivant dans le flux renvoyé.

Obtenir des contacts partagés à l'aide de paramètres de requête

Demandez des contacts correspondant à des critères spécifiques, par exemple ceux mis à jour après une certaine date. Les requêtes en texte intégral et les recherches d'adresses e-mail ne sont pas acceptées. Pour tous les paramètres de requête, consultez le guide de référence de l'API Domain Shared Contacts.

  1. Envoyez une requête HTTP GET à l'URL du flux de contacts avec un paramètre :

    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER

    Remplacez les éléments suivants :

    Par exemple, pour obtenir les entrées mises à jour après le 16 mars 2022 pour example.com, ajoutez le paramètre updated-min :

    GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00

    Le serveur renvoie un code d'état HTTP 200 OK et un flux avec les correspondances.

  2. Les flux renvoient un maximum de 10 Mo dans une seule réponse. Pour obtenir la liste complète, cliquez plusieurs fois sur le lien Suivant dans le flux renvoyé.

Suivre les modifications incrémentales

Pour suivre les modifications apportées à une liste de contacts partagée dans un domaine : 1. Notez la valeur de l'élément <updated> du flux. 1. Demandez les contacts modifiés en définissant updated-min sur cette valeur <updated> et showdeleted sur true.

Obtenir un seul contact partagé

Pour obtenir un contact spécifique, utilisez son lien personnel, que vous trouverez dans le flux de contacts partagés. Pour en savoir plus, consultez Obtenir tous les contacts partagés.

  1. Pour obtenir un contact spécifique, envoyez une requête HTTP GET au lien self du contact : 
    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/SELF_LINK
     Remplacez les éléments suivants :
  • DOMAIN : votre domaine (par exemple, example.com).
  • PROJECTION : valeur de la projection. Pour connaître les valeurs acceptées, consultez Valeurs de projection.
  • SELF_LINK : valeur numérique unique du contact.

Le serveur renvoie un code d'état HTTP 200 OK et l'entrée de contact.

Par exemple, pour obtenir un contact avec le lien auto https://www.google.com/m8/feeds/contacts/example.com/full/12345 :

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

Étapes suivantes