Тип ресурса person
Пространство имен: 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"
}