Obtenir les contacts partagés

Vous pouvez demander l'accès à des contacts partagés différentes manières:

  • Tous les contacts partagés
  • Ensemble de contacts qui correspondent à un critère spécifié
  • Un seul contact partagé
  • La photo d'un contact

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

Récupérer tous les contacts partagés

  1. Pour récupérer tous les contacts partagés, envoyez une requête HTTP GET au URL du flux de contacts:

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

    Remplacez les éléments suivants :

    • DOMAIN: URL de votre domaine (par exemple, exemple.fr.
    • PROJECTION: valeur de projection qui spécifie les éléments gd:extendedProperty. Pour obtenir la liste des valeurs acceptées, consultez Valeurs de projection :

    Le flux renvoie un code d'état HTTP 200 OK et un code d'état Atom 1.0 standard contenant les contacts. Voici un exemple de liste de contacts avec une seule 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. Le flux ne renvoie pas plus de 10 Mo en une seule réponse. À obtenir la liste complète des contacts, suivre à plusieurs reprises le flux Next (Suivant) jusqu'à ce qu'il ne s'affiche plus dans le flux de retour.

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

Vous pouvez demander un ensemble de contacts correspondant à un tels que les demandes de contacts mis à jour après une date donnée. Il n'y a aucun pour les requêtes en texte intégral ou la localisation d'un contact par son adresse e-mail. Pour une la liste complète des paramètres de requête acceptés, voir 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 :

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

    Remplacez les éléments suivants :

    Par exemple, pour mettre à jour toutes les entrées des contacts partagés du domaine Le 16 mars 2022 (par exemple, example.com) envoie une requête HTTP au domaine partagé URL du flux de contacts et ajoutez le paramètre updated-min à l'URL de la requête:

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

    Lorsque vous envoyez cette requête GET, le serveur renvoie une réponse HTTP 200 OK code d'état et un flux contenant tous les contacts partagés du domaine qui ont été créées ou mises à jour après la date spécifiée.

  2. Le flux ne renvoie pas plus de 10 Mo en une seule réponse. À d'obtenir à plusieurs reprises la liste complète des contacts correspondant aux critères spécifiés Suivez le lien Suivant du flux renvoyé jusqu'à ce qu'il disparaisse. dans le flux de retour.

Suivre les modifications incrémentielles

Pour effectuer le suivi des modifications incrémentielles apportées à une liste de contacts partagés au sein d'un domaine, procédez comme suit : suivantes: 1. Lorsque vous envoyez une demande de flux, effectuez le suivi de la valeur du paramètre l'élément <updated> du flux. 1. Vous pouvez afficher uniquement les contacts partagés du domaine qui ont été modifiés depuis le la requête précédente en définissant le paramètre de requête updated-min sur cette valeur <updated>, et le paramètre De showdeleted à true.

Obtenir un contact partagé unique

Pour obtenir un contact partagé unique, vous devez utiliser le lien "self" du contact. Vous pouvez obtenir le lien auto du contact partagé en recherchant l'entrée correspondante flux de contacts partagés. Si vous ne savez pas quelle valeur utiliser pour le lien auto, Voir la section Obtenir tous les contacts et Récupérer des contacts à l'aide de paramètres de requête

  1. Pour obtenir un contact partagé spécifique au sein du domaine, envoyez un GET HTTP au lien auto d'un contact: 
    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK>
    Remplacez les éléments suivants:
  • DOMAIN: URL de votre domaine (par exemple, exemple.fr.
  • PROJECTION: valeur de projection spécifiant le gd:extendedProperty. Pour obtenir la liste des valeurs acceptées, consultez Valeurs de projection :
  • SELF_LINK: valeur numérique unique qui représente une contact partagé unique, par exemple, 12345.

Le serveur renvoie ensuite un code d'état HTTP 200 OK et une entrée contenant le contact.

Par exemple, pour récupérer un contact partagé au sein du domaine dont le lien auto est défini sur https://www.google.com/m8/feeds/contacts/example.com/full/12345, envoyez le la requête HTTP suivante:

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

Étapes suivantes