Introduction

L'API People vous permet de:

  • Lire et gérer les contacts de l'utilisateur authentifié
  • Lisez et copiez les autres contacts de l'utilisateur authentifié.
  • Lire les informations de profil des utilisateurs authentifiés et de leurs contacts
  • Lire les profils et les contacts du domaine

Par exemple, supposons que l'utilisateur authentifié, Jen, possède Fabian et Ranjith dans ses contacts privés. Lorsque votre application appelle people.connections.list pour lire la liste de ses connexions, un écran d'autorisation s'affiche pour lui demander d'autoriser l'application à accéder à la liste. Si Jen consent, l'application lit une liste contenant person resources pour Fabian et Ranjith.

Si l'application a besoin d'informations sur une personne spécifique, elle peut appeler people.get en transmettant un nom de ressource, afin d'obtenir l'objet person resource pour cette personne.

L'application peut également gérer les contacts en créant des contacts à l'aide de people.createContact, mettre à jour les contacts existants lus depuis people.connections.list à l'aide de people.updateContact et supprimer des contacts avec people.deleteContact.

Les utilisateurs Google Workspace peuvent également répertorier leurs profils et contacts de domaine d'annuaire à l'aide de people.listDirectoryPeople, ou les rechercher à l'aide de people.searchDirectoryPeople.

Vue fusionnée des informations sur les personnes

Les informations sur les personnes lues par l'API People sont fusionnées à partir de différentes sources, selon les conditions suivantes:

Source Condition
Données de profil Google publiques Toujours.
Données de profil de domaine Google Workspace L'administrateur du domaine a activé le partage externe des profils et des profils des données à l'échelle du domaine, et le champ d'application directory.readonly a été accordé
Les informations de profil privé de l'utilisateur authentifié L'un des champs d'application profile a été accordé.
Les contacts de l'utilisateur authentifié Le champ d'application contacts a été accordé.

Comprendre les données fusionnées des personnes

Les données concernant une personne proviennent d'un type de source principal. Les données d'autres sources sont fusionnées avec celles-ci si les sources sont connectées via des adresses e-mail, des numéros de téléphone ou des URL de profil validés. Voici comment les individus peuvent être composés:

Source principale Contacts Profils Profils de domaine Google Workspace Contacts du domaine Google Workspace Utilisation
Contact 1 0+ 0+ 0+ Renvoyé pour la plupart des points de terminaison
Profil 0+ 1 0 ou 1 0 Est renvoyé dans people.get lorsqu'il est utilisé pour obtenir la personne pour l'utilisateur connecté ou pour une personne pour le compte Google d'un autre utilisateur.
Contact du domaine 0+ 0 0 1 Renvoyé dans people.listDirectoryPeople ou people.searchDirectoryPeople.

Seules les personnes basées sur les contacts peuvent être modifiées par les points de terminaison de mutation. Les mutations de profil et de contact de domaine ne sont pas acceptées.