Method: people.get

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/contacts
  • https://www.googleapis.com/auth/contacts.readonly
  • https://www.googleapis.com/auth/contacts.other.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
  • https://www.googleapis.com/auth/profile.language.read

Więcej informacji znajdziesz w przewodniku po autoryzacji.