Method: people.get

Zawiera informacje o osobie, określając nazwę zasobu. Użyj people/me, aby wskazać uwierzytelnionego użytkownika.

Jeśli nie określono pola „personFields”, żą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

Wymagany. Nazwa zasobu osoby, dla której chcesz podać informacje.

  • Aby uzyskać informacje o uwierzytelnionym użytkowniku, wpisz people/me.
  • Aby uzyskać informacje o koncie Google, podaj people/{account_id}.
  • Aby uzyskać informacje o kontaktie, określ nazwę zasobu, który identyfikuje kontakt jako zwrócony przez people.connections.list.

Parametry zapytania

Parametry
requestMask
(deprecated)

object (RequestMask)

WYCOFANO (zamiast tego użyj personFields)

Maska, która ogranicza wyniki do podzbioru pól osób.

personFields

string (FieldMask format)

Wymagany. Maska pola, która określa, które pola danej osoby są zwracane. Możesz określić wiele pól, rozdzielając je przecinkami. Prawidłowe wartości to:

  • adresy
  • przedziały wiekowe
  • biografie
  • urodziny
  • kalendarzUrl
  • daneklienta
  • Zdjęcia na okładkę
  • adresy-e-mail
  • wydarzenia
  • externalIds
  • płeć
  • klienty
  • zainteresowania
  • języki
  • lokalizacje
  • kanału
  • metadane
  • inne słowa kluczowe
  • imiona i nazwiska
  • pseudonimy
  • zawody
  • organizacje
  • numery telefonów
  • zdjęcia
  • relacje
  • adresy sip
  • umiejętności
  • adresy
  • definiowany przez użytkownika
sources[]

enum (ReadSourceType)

Opcjonalne. Maska typu 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/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

Więcej informacji znajdziesz w przewodniku po autoryzacji.