Method: people.get
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Предоставляет информацию о человеке, указывая имя ресурса. Используйте people/me
для указания аутентифицированного пользователя.
Запрос возвращает ошибку 400, если «personFields» не указан.
HTTP-запрос
GET https://people.googleapis.com/v1/{resourceName=people/*}
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры |
---|
resourceName | string Необходимый. Ресурсное имя лица, о котором необходимо предоставить информацию. - Чтобы получить информацию об аутентифицированном пользователе, укажите
people/me . - Чтобы получить информацию об учетной записи Google, укажите
people/{account_id} . - Чтобы получить информацию о контакте, укажите имя ресурса, которое идентифицирует контакт, возвращенный
people.connections.list .
|
Параметры запроса
Параметры |
---|
requestMask (deprecated) | object ( RequestMask ) УСТАРЕЛО (пожалуйста, используйте вместо этого personFields ) Маска для ограничения результатов подмножеством полей пользователя. |
personFields | string ( FieldMask format) Необходимый. Маска поля для ограничения возвращаемых полей человека. Можно указать несколько полей, разделив их запятыми. Допустимые значения: - адреса
- возрастные диапазоны
- биографии
- дни рождения
- URL календаря
- клиентские данные
- фото на обложке
- адрес электронной почты
- События
- внешние идентификаторы
- пол
- imClients
- интересы
- локали
- локации
- членство
- метаданные
- разноеКлючевые слова
- имена
- прозвища
- занятия
- организации
- телефонные номера
- фотографии
- связи
- sipАдрес
- навыки
- URL-адреса
- определяемые пользователем
|
sources[] | enum ( ReadSourceType ) По желанию. Маска исходных типов для возврата. По умолчанию это READ_SOURCE_TYPE_PROFILE и READ_SOURCE_TYPE_CONTACT , если они не установлены. |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
В случае успеха тело ответа содержит экземпляр Person
.
Области авторизации
Для доступа к общедоступным данным авторизация не требуется. Для личных данных требуется одна из следующих областей действия 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
Дополнительные сведения см. в руководстве по авторизации .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2023-02-23 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Отсутствует нужная мне информация"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Слишком сложен/слишком много шагов"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Устарел"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Проблема с переводом текста"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Проблемы образцов/кода"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Другое"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Прост для понимания"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Помог мне решить мою проблему"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Другое"
}]