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[] |
Wymagane. Nazwy zasobów osób, o których chcesz uzyskać informacje. Jest powtarzalna. Parametr zapytania w adresie URL powinien mieć postać
Maksymalna liczba nazw zasobów to 200. |
requestMask |
WYCOFANE (zamiast tego użyj Maska ograniczająca wyniki do podzbioru pól dotyczących osób. |
personFields |
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:
|
sources[] |
Opcjonalnie. Maska typów źródeł do zwrócenia. Jeśli nie zostanie ustawiony, domyślna wartość to |
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 ( |
Pola | |
---|---|
responses[] |
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
https://www.googleapis.com/auth/profile.language.read
Więcej informacji znajdziesz w przewodniku po autoryzacji.