Introduction

L'API People vous permet d'effectuer les opérations suivantes:

  • Consulter et gérer les contacts de l'utilisateur authentifié
  • Lire et copier la section Autres contacts de l'utilisateur authentifié
  • Lire les informations de profil des utilisateurs authentifiés et de leurs contacts
  • Consulter les profils et les contacts du domaine

Par exemple, supposons que Jen, l'utilisateur authentifiée, ait accès à "Fabian" et "Ranjith" dans ses contacts privés. Lorsque votre application appelle people.connections.list pour lire la liste de ses connexions, Jen voit un écran de consentement lui demandant d'autoriser l'application à accéder à cette liste. Si Jen donne son consentement, l'application lit une liste contenant person resources pour Fabian et Ranjith.

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

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

Les utilisateurs Google Workspace peuvent également répertorier leurs profils de domaine d'annuaire et leurs contacts de domaine à 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 en fonction des conditions suivantes:

Source Condition
Données de profil Google public Définitivement.
Les données de profil du domaine Google Workspace L'administrateur de domaine a activé le partage externe des contacts 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ées de l'utilisateur authentifié L'un des niveaux d'accès profile a été accordé.
Les contacts de l'utilisateur authentifié Le champ d'application contacts a été accordé.

Comprendre les données fusionnées sur les personnes

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

Source principale Contacts Profils Profils de domaine Google Workspace Contacts du domaine Google Workspace Utilisation
Contact 1 0+ 0+ 0+ Retourné 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 l'utilisateur pour l'utilisateur connecté ou pour obtenir une personne pour le compte Google d'un autre utilisateur.
Contact du domaine 0+ 0 0 1 Retourné dans people.listDirectoryPeople ou people.searchDirectoryPeople.

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