Method: people.getBatchGet

Zawiera informacje o liście konkretnych osób przez określenie listy żądanych nazw zasobów. 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/people:batchGet

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
resourceNames[]

string

To pole jest wymagane. Nazwy zasobów osób, o których chcesz uzyskać informacje. Jest powtarzalna. Parametr zapytania w adresie URL powinien mieć postać

resourceNames=<name1>&resourceNames=<name2>&...

  • 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.

Maksymalna liczba nazw zasobów to 200.

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)

To pole jest wymagane. Maska pola określająca, które pola każdej osoby 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_CONTACT i READ_SOURCE_TYPE_PROFILE.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na żądanie pobrania listy osób według nazwy zasobu.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "responses": [
    {
      object (PersonResponse)
    }
  ]
}
Pola
responses[]

object (PersonResponse)

Odpowiedź dla każdej żądanej nazwy zasobu.

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

Więcej informacji znajdziesz w przewodniku po autoryzacji.