Method: people.get
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 la 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 la ressource qui identifie le contact tel que 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 renvoyés pour la personne. Vous pouvez spécifier plusieurs champs en les séparant par une virgule. Les valeurs possibles sont les suivantes :
- addresses
- ageRanges
- biographies
- anniversaires
- calendarUrls
- clientData
- coverPhotos
- emailAddresses
- événements
- externalIds
- critères de sexe
- imClients
- centres d'intérêt
- locales
- emplacement
- aux chaînes
- métadonnées
- miscKeywords
- names
- surnoms
- professions
- organizations
- phoneNumbers
- photos
- relations
- sipAddresses
- skills
- urls
- userDefined
|
sources[] |
enum (ReadSourceType)
Facultatif. Masque les types de sources à renvoyer. La valeur par défaut est READ_SOURCE_TYPE_PROFILE, et READ_SOURCE_TYPE_CONTACT si ce n'est pas le cas.
|
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 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/contactshttps://www.googleapis.com/auth/contacts.readonlyhttps://www.googleapis.com/auth/contacts.other.readonlyhttps://www.googleapis.com/auth/directory.readonlyhttps://www.googleapis.com/auth/profile.agerange.readhttps://www.googleapis.com/auth/profile.emails.readhttps://www.googleapis.com/auth/profile.language.readhttps://www.googleapis.com/auth/user.addresses.readhttps://www.googleapis.com/auth/user.birthday.readhttps://www.googleapis.com/auth/user.emails.readhttps://www.googleapis.com/auth/user.gender.readhttps://www.googleapis.com/auth/user.organization.readhttps://www.googleapis.com/auth/user.phonenumbers.readhttps://www.googleapis.com/auth/userinfo.emailhttps://www.googleapis.com/auth/userinfo.profilehttps://www.googleapis.com/auth/profile.language.read
Pour en savoir plus, consultez le guide relatif aux autorisations.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/08/06 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2024/08/06 (UTC)."],[[["Retrieves information about a person, including the authenticated user using `people/me` or by specifying a resource name."],["Requires the `personFields` query parameter to specify which fields to include in the response, otherwise, it returns a 400 error."],["Allows filtering the source of the data using the `sources[]` parameter and supports various authorization scopes for accessing private data."],["Uses a `GET` request to the `https://people.googleapis.com/v1/{resourceName=people/*}` endpoint with optional query parameters."],["Response includes a [Person](/people/api/rest/v1/people#Person) object containing the requested information if successful."]]],["This outlines how to retrieve person information via a `GET` request to `https://people.googleapis.com/v1/{resourceName=people/*}`. The `resourceName` path parameter specifies the person (e.g., `people/me` for the authenticated user). The `personFields` query parameter is mandatory and dictates the data returned. The request body must be empty. A successful request returns a `Person` resource. Authorization is needed for private data. A `400` error is returned if `personFields` is not specified.\n"]]
