People API

Permet d'accéder aux informations sur les profils et les contacts.

Service: people.googleapis.com

Pour appeler ce service, nous vous recommandons d'utiliser les bibliothèques clientes fournies par Google. Si votre application doit utiliser vos propres bibliothèques pour appeler ce service, utilisez les informations suivantes lorsque vous effectuez les requêtes API.

Document de découverte

Un document de découverte est une spécification exploitable par un ordinateur qui permet de décrire et de consommer les API REST. Ce document permet de créer des bibliothèques clientes, des plug-ins IDE et d'autres outils qui interagissent avec les API Google. Un même service peut fournir plusieurs documents de découverte. Ce service fournit le document de découverte suivant :

Point de terminaison du service

Un point de terminaison de service est une URL de base qui spécifie l'adresse réseau d'un service d'API. Un service peut disposer de plusieurs points de terminaison de service. Ce service possède le point de terminaison de service suivant, et tous les URI ci-dessous sont relatifs à ce point de terminaison de service :

  • https://people.googleapis.com

Ressource REST: v1.contactGroups

Méthodes
batchGet GET /v1/contactGroups:batchGet
Obtenez une liste des groupes de contacts appartenant à l'utilisateur authentifié en spécifiant une liste de noms de ressources de groupe de contacts.
create POST /v1/contactGroups
Créez un groupe de contacts appartenant à l'utilisateur authentifié.
delete DELETE /v1/{resourceName=contactGroups/*}
Supprimez un groupe de contacts existant appartenant à l'utilisateur authentifié en spécifiant un nom de ressource de groupe de contacts.
get GET /v1/{resourceName=contactGroups/*}
Obtenez un groupe de contacts spécifique appartenant à l'utilisateur authentifié en spécifiant un nom de ressource de groupe de contacts.
list GET /v1/contactGroups
Répertoriez tous les groupes de contacts appartenant à l'utilisateur authentifié.
update PUT /v1/{contactGroup.resourceName=contactGroups/*}
Mettez à jour le nom d'un groupe de contacts existant appartenant à l'utilisateur authentifié.

Ressource REST: v1.contactGroups.members

Méthodes
modify POST /v1/{resourceName=contactGroups/*}/members:modify
Modifier les membres d'un groupe de contacts appartenant à l'utilisateur authentifié.

Ressource REST: v1.otherContacts

Méthodes
copyOtherContactToMyContactsGroup POST /v1/{resourceName=otherContacts/*}:copyOtherContactToMyContactsGroup

Copie un "Autre contact" vers un nouveau contact du groupe "myContacts " de l'utilisateur

Les requêtes de mutation pour un même utilisateur doivent être envoyées de manière séquentielle pour éviter une latence accrue et des échecs.

list GET /v1/otherContacts
Répertoriez tous les contacts de la catégorie "Autres contacts", c'est-à-dire ceux qui ne font pas partie d'un groupe de contacts.
search GET /v1/otherContacts:search
Fournit une liste de contacts parmi les autres contacts de l'utilisateur authentifié qui correspond à la requête de recherche.

Ressource REST: v1.people

Méthodes
batchCreateContacts POST /v1/people:batchCreateContacts

Créer un lot de nouveaux contacts et renvoyer les réponses PersonResponse pour les nouveaux

Les requêtes de mutation pour un même utilisateur doivent être envoyées de manière séquentielle pour éviter une latence accrue et des échecs.

batchDeleteContacts POST /v1/people:batchDeleteContacts
Supprimez un lot de contacts.
batchUpdateContacts POST /v1/people:batchUpdateContacts
Met à jour un lot de contacts et renvoie un mappage de noms de ressources vers PersonResponses pour les contacts mis à jour.
createContact POST /v1/people:createContact
Créez un contact et renvoyez la ressource de personne pour ce contact.
deleteContact DELETE /v1/{resourceName=people/*}:deleteContact
Supprimer un contact.
deleteContactPhoto DELETE /v1/{resourceName=people/*}:deleteContactPhoto
Supprimez la photo d'un contact.
get GET /v1/{resourceName=people/*}
Fournit des informations sur une personne en spécifiant un nom de ressource.
getBatchGet GET /v1/people:batchGet
Fournit des informations sur une liste de personnes spécifiques en spécifiant une liste de noms de ressources demandés.
listDirectoryPeople GET /v1/people:listDirectoryPeople
Fournit une liste des profils de domaine et des contacts du domaine dans l'annuaire de domaine de l'utilisateur authentifié.
searchContacts GET /v1/people:searchContacts
Fournit une liste de contacts parmi les contacts groupés de l'utilisateur authentifié qui correspondent à la requête de recherche.
searchDirectoryPeople GET /v1/people:searchDirectoryPeople
Fournit une liste des profils de domaine et des contacts du domaine dans l'annuaire de domaine de l'utilisateur authentifié qui correspondent à la requête de recherche.
updateContact PATCH /v1/{person.resourceName=people/*}:updateContact
Mettez à jour les données de contact d'un contact existant.
updateContactPhoto PATCH /v1/{resourceName=people/*}:updateContactPhoto
Mettez à jour la photo d'un contact.

Ressource REST: v1.people.connections

Méthodes
list GET /v1/{resourceName=people/*}/connections
Fournit la liste des contacts de l'utilisateur authentifié.