Method: people.get

Fournit des informations sur une personne en spécifiant un nom de ressource. Utilisez people/me pour indiquer l'utilisateur authentifié.

La requête renvoie une erreur 400 si "personFields" n'est pas spécifié.

Requête HTTP :

GET https://people.googleapis.com/v1/{resourceName=people/*}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
resourceName

string

Obligatoire. Nom de ressource de la personne sur laquelle fournir des informations.

  • Pour obtenir des informations sur l'utilisateur authentifié, spécifiez people/me.
  • Pour obtenir des informations sur un compte Google, spécifiez people/{account_id}.
  • Pour obtenir des informations sur un contact, spécifiez le nom de ressource qui identifie le contact comme renvoyé par people.connections.list.

Paramètres de requête

Paramètres
requestMask
(deprecated)

object (RequestMask)

OBSOLÈTE (veuillez utiliser personFields à la place)

Masque permettant de limiter les résultats à un sous-ensemble de champs de personne.

personFields

string (FieldMask format)

Obligatoire. Masque de champ permettant de limiter les champs à renvoyer. Vous pouvez spécifier plusieurs champs en les séparant par une virgule. Les valeurs possibles sont les suivantes :

  • addresses
  • tranches d'âge
  • biographies
  • anniversaires
  • calendarUrls
  • clientData
  • photosdecouverture
  • emailAddresses
  • événements
  • ID externes
  • critères de sexe
  • ImClients
  • centres d'intérêt
  • locales
  • zones géographiques
  • aux chaînes
  • metadata
  • Divers mots clés
  • names
  • pseudonymes
  • professions
  • organizations
  • phoneNumbers
  • photos
  • relations
  • SipAddresses
  • skills
  • URL
  • défini par l'utilisateur
sources[]

enum (ReadSourceType)

Facultatif. Masque des types de sources à renvoyer. Si ce n'est pas le cas, les valeurs par défaut sont READ_SOURCE_TYPE_PROFILE et READ_SOURCE_TYPE_CONTACT.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Person.

Champs d'application des autorisations

Aucune autorisation n'est requise pour accéder aux données publiques. Pour les données privées, l'un des champs d'application OAuth suivants est requis:

  • https://www.googleapis.com/auth/contacts
  • https://www.googleapis.com/auth/contacts.readonly
  • https://www.googleapis.com/auth/directory.readonly
  • https://www.googleapis.com/auth/profile.agerange.read
  • https://www.googleapis.com/auth/profile.emails.read
  • https://www.googleapis.com/auth/profile.language.read
  • https://www.googleapis.com/auth/user.addresses.read
  • https://www.googleapis.com/auth/user.birthday.read
  • https://www.googleapis.com/auth/user.emails.read
  • https://www.googleapis.com/auth/user.gender.read
  • https://www.googleapis.com/auth/user.organization.read
  • https://www.googleapis.com/auth/user.phonenumbers.read
  • https://www.googleapis.com/auth/userinfo.email
  • https://www.googleapis.com/auth/userinfo.profile

Pour en savoir plus, consultez le guide relatif aux autorisations.