Method: people.get
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zawiera informacje o osobie, określając nazwę zasobu. Użyj people/me, aby wskazać uwierzytelnionego użytkownika.
Jeśli wartość „personFields” nie jest określona, żądanie zwraca błąd 400.
Żądanie HTTP
GET https://people.googleapis.com/v1/{resourceName=people/*}
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
resourceName |
string
Wymagane. Nazwa zasobu osoby, o której należy udostępnić informacje.
- Aby uzyskać informacje o uwierzytelnionym użytkowniku, wpisz
people/me.
- Aby uzyskać informacje o koncie Google, wpisz
people/{account_id}.
- Aby uzyskać informacje o kontakcie, podaj nazwę zasobu, która identyfikuje kontakt zwrócony przez
people.connections.list
|
Parametry zapytania
| Parametry |
requestMask
(deprecated) |
object (RequestMask)
WYCOFANE (zamiast tego użyj personFields) Maska ograniczająca wyniki do podzbioru pól dotyczących osób.
|
personFields |
string (FieldMask format)
Wymagane. Maska pola określająca, które pola mają być zwracane. Można określić wiele pól, rozdzielając je przecinkami. Prawidłowe wartości to:
- adresy
- ageRanges
- biografie
- urodziny
- calendarUrls
- clientData
- coverPhotos
- emailAddresses
- wydarzenia
- externalIds
- płeć
- imClients
- zainteresowania
- locales
- lokalizacje
- kanału
- metadane
- miscKeywords
- names
- pseudonimy
- zawody
- organizations
- phoneNumbers
- fotografie
- relacje
- sipAddresses
- umiejętności
- urls
- userDefined
|
sources[] |
enum (ReadSourceType)
Opcjonalnie. Maska typów źródeł do zwrócenia. Jeśli nie zostanie ustawiony, domyślna wartość to READ_SOURCE_TYPE_PROFILE i READ_SOURCE_TYPE_CONTACT.
|
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Person.
Zakresy autoryzacji
Dostęp do danych publicznych nie wymaga autoryzacji. W przypadku danych prywatnych wymagany jest jeden z tych zakresów OAuth:
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
Więcej informacji znajdziesz w przewodniku po autoryzacji.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-08-06 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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"]]
