Тип ресурса person

Статья
06/02/2023

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Представляет агрегирование сведений о человеке из почты и контактов. Люди могут быть локальные контакты или каталог вашей организации, а также люди из последних сообщений (например, электронной почты).

Методы

Метод	Возвращаемый тип	Описание
List people	person	Получение коллекции объектов person, упорядоченных по их релевантности для пользователя.

Свойства

Свойство	Тип	Описание
birthday	String	День рождения человека.
companyName	String	Название компании человека.
department	String	Отдел, в котором работает человек.
displayName	String	Отображаемое имя человека.
emailAddresses	коллекция rankedEmailAddress	Электронные адреса человека.
givenName	String	Имя человека.
id	String	Уникальный идентификатор пользователя. Только для чтения.
isFavorite	Boolean	Имеет значение `True`, если пользователь добавил этого человека в список избранных.
mailboxType	String	Тип почтового ящика, представленного адресом электронной почты пользователя.
officeLocation	String	Расположение офиса человека.
personNotes	String	Заметки в произвольной форме о человеке, созданные пользователем.
personType	String	Тип пользователя, например список рассылки.
phones	Коллекция phone	Номера телефонов человека.
postalAddresses	Коллекция location	Адреса человека.
profession	String	Профессия человека.
sources	Коллекция personDataSource	Источники, из которые поступают данные пользователя, например Каталог или Контакты Outlook.
surname	String	Фамилия человека.
title	String	Название пользователя.
userPrincipalName	String	Имя участника-пользователя (UPN) пользователя. Имя участника-пользователя — это имя для входа в интернет-стиле для пользователя, основанное на стандарте Интернета RFC 822. По соглашению это должно сопоставляться с именем электронной почты пользователя. Общий формат — `alias@domain`.
websites	Коллекция website	Веб-сайты человека.
yomiCompany	String	Название компании человека, записанное так, как оно звучит по-японски.

Связи

Отсутствуют.

Представление JSON

Ниже указано представление ресурса в формате JSON.

{
  "birthday": "String",
  "companyName": "String",
  "department": "String",
  "displayName": "String",
  "emailAddresses": [{"@odata.type": "microsoft.graph.rankedEmailAddress"}],
  "givenName": "String",
  "id": "String (identifier)",
  "isFavorite": "Boolean",
  "mailboxType": "String",
  "officeLocation": "String",
  "personNotes": "String",
  "personType": "String",
  "phones": [{"@odata.type": "microsoft.graph.phone"}],
  "postalAddresses": [{"@odata.type": "microsoft.graph.location"}],
  "profession": "String",
  "sources": [{"@odata.type": "microsoft.graph.personDataSource"}],
  "surname": "String",
  "title": "String",
  "userPrincipalName": "String",
  "websites": [{"@odata.type": "microsoft.graph.website"}],
  "yomiCompany": "String"
}