Method: people.get
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Liefert Informationen zu einer Person durch Angabe eines Ressourcennamens. Verwenden Sie people/me, um den authentifizierten Nutzer anzugeben.
Die Anfrage gibt einen 400-Fehler zurück, wenn „personFields“ nicht angegeben ist.
HTTP-Anfrage
GET https://people.googleapis.com/v1/{resourceName=people/*}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
resourceName |
string
Erforderlich. Der Ressourcenname der Person, zu der Informationen angegeben werden sollen.
- Geben Sie
people/me an, um Informationen zum authentifizierten Nutzer abzurufen.
- Geben Sie
people/{account_id} an, um Informationen zu einem Google-Konto abzurufen.
- Wenn Sie Informationen zu einem Kontakt abrufen möchten, geben Sie den Ressourcennamen an, der den von
people.connections.list
|
Abfrageparameter
| Parameter |
requestMask
(deprecated) |
object (RequestMask)
EINGESTELLT (Verwenden Sie stattdessen personFields.) Eine Maske, mit der die Ergebnisse auf eine Teilmenge von Personenfeldern beschränkt werden.
|
personFields |
string (FieldMask format)
Erforderlich. Eine Feldmaske, mit der eingeschränkt wird, welche Felder für eine Person zurückgegeben werden. Sie können mehrere Felder angeben, indem Sie sie durch Kommas trennen. Gültige Werte sind:
- addresses
- ageRanges
- biografien
- Geburtstage
- calendarUrls
- clientData
- coverPhotos
- emailAddresses
- Veranstaltungen
- externalIds
- geschlechter
- imClients
- interessen
- locales
- Standorte
- mitgliedschaft
- Metadaten
- miscKeywords
- names
- Spitznamen
- Berufe
- organizations
- phoneNumbers
- fotos
- Beziehungen
- sipAddresses
- skills
- urls
- userDefined
|
sources[] |
enum (ReadSourceType)
Optional. Eine Maske, die angibt, welche Quelltypen zurückgegeben werden sollen. Wenn kein Wert festgelegt wird, werden standardmäßig READ_SOURCE_TYPE_PROFILE und READ_SOURCE_TYPE_CONTACT verwendet.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Person.
Autorisierungsbereiche
Für den Zugriff auf öffentliche Daten ist keine Autorisierung erforderlich. Für private Daten ist einer der folgenden OAuth-Bereiche erforderlich:
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
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-08-06 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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"]]
