Предоставляет информацию о списке конкретных людей, указывая список имен запрошенных ресурсов. Используйте people/me
чтобы указать аутентифицированного пользователя.
Запрос возвращает ошибку 400, если «personFields» не указан.
HTTP-запрос
GET https://people.googleapis.com/v1/people:batchGet
URL-адрес использует синтаксис транскодирования gRPC .
Параметры запроса
Параметры | |
---|---|
resourceNames[] | Необходимый. Имена ресурсов людей, о которых нужно предоставить информацию. Это повторяемо. Параметр запроса URL должен быть
Существует максимум 200 имен ресурсов. |
requestMask | УСТАРЕЛО (вместо этого используйте Маска, позволяющая ограничить результаты подмножеством личных полей. |
personFields | Необходимый. Маска поля, позволяющая ограничить возвращаемые поля для каждого человека. Можно указать несколько полей, разделив их запятыми. Допустимые значения:
|
sources[] | Необязательный. Маска того, какие типы источников возвращаются. По умолчанию — |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
Ответ на запрос на получение списка людей по имени ресурса.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"responses": [
{
object ( |
Поля | |
---|---|
responses[] | Ответ для каждого запрошенного имени ресурса. |
Области авторизации
Для доступа к общедоступным данным не требуется авторизация. Для личных данных требуется одна из следующих областей 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
Дополнительную информацию см. в руководстве по авторизации .