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

Дополнительные сведения см. в руководстве по авторизации .