Тип ресурса educationUser
Пространство имен: microsoft.graph
Пользователь в системе. Это зависящий от образования вариант пользователя с тем же идентификатором , который Microsoft Graph будет возвращать из конечной точки, отличной /users от образования. Этот объект предоставляет целевое подмножество свойств из основного объекта пользователя и добавляет набор свойств, относящихся к образованию, таких как данные primaryRole, student и teacher .
Наследует от сущности.
Методы
| Метод | Тип возвращаемых данных | Описание |
|---|---|---|
| Список | Коллекция educationUser | Получите список объектов educationUser и их свойств. |
| Создание | educationUser | Создайте новый объект educationUser . |
| Получение | educationUser | Чтение свойств и связей объекта educationUser . |
| Обновление | educationUser | Обновление свойств объекта educationUser . |
| удаление; | Нет | Удаление объекта educationUser. |
| Получение изменений для пользователей | Коллекция educationUser | Получение добавочных изменений в коллекции ресурсов. |
| Список преподаваемого класса | Коллекция educationClass | Получите ресурсы educationClass из свойства навигации taughtClasses . |
Свойства
| Свойство | Тип | Описание |
|---|---|---|
| accountEnabled | Логический | Если учетная запись обеспечена — True, в противном случае — false. Это свойство обязательно указывать при создании пользователя. Поддерживает $filter. |
| assignedLicenses | Коллекция assignedLicense | Лицензии, назначенные пользователю. Значение null не допускается. |
| assignedPlans | Коллекция assignedPlan | Планы, назначенные пользователю. Только для чтения. Значение null не допускается. |
| businessPhones | Коллекция строк | Номера телефонов пользователя. Примечание. Несмотря на то что это коллекция строк, для этого свойства можно задать только один номер. |
| createdBy | identitySet | Сущность, создавшая пользователя. |
| department | String | Название отдела, в котором работает пользователь. Поддерживает $filter. |
| displayName | String | Имя пользователя, отображаемое в адресной книге. Обычно это сочетание имени, отчества и фамилии пользователя. Это свойство необходимо указывать при создании пользователя. Его невозможно удалить при обновлении. Поддерживает $filter и $orderby. |
| externalSource | educationExternalSource | Источник для создания пользователя. Возможные значения: sis, manual. |
| externalSourceDetail | String | Имя внешнего источника, из который был создан этот ресурс. |
| givenName; | String | Простое имя пользователя. Поддерживает $filter. |
| id | String | Идентификатор объекта. Наследуется от сущности. |
| почта; | String | SMTP-адрес пользователя, например jeff@contoso.com. Только для чтения. Поддерживает $filter. |
| mailingAddress | physicalAddress | Почтовый адрес пользователя. |
| mailNickname | String | Почтовый псевдоним для пользователя. Это свойство должно быть указано при создании пользователя. Поддерживает $filter. |
| middleName | String | Отчество пользователя. |
| mobilePhone | String | Основной сотовый телефон пользователя. |
| officeLocation | String | Расположение офиса пользователя. |
| onPremisesInfo | educationOnPremisesInfo | Дополнительные сведения, используемые для связывания пользователя Microsoft Entra с его аналогом Active Directory. |
| passwordPolicies | String | Задает политики паролей для пользователя. Это свойство представляет собой перечисление с возможным значением DisableStrongPassword. Оно позволяет использовать менее надежные пароли, чем предусмотрено политикой по умолчанию. Вы также можете указать значение DisablePasswordExpiration. Их можно указать вместе; например: DisablePasswordExpiration, DisableStrongPassword. |
| passwordProfile | passwordProfile | Задает профиль пароля для пользователя. Профиль содержит пароль пользователя. Это свойство обязательно указывать при создании пользователя. Пароль в профиле должен соответствовать минимальным требованиям, указанным в свойстве passwordPolicies. По умолчанию требуется надежный пароль. |
| preferredLanguage | String | Предпочтительный язык для пользователя, который должен соответствовать коду ISO 639-1, например en-US. |
| primaryRole | educationUserRole | Роль по умолчанию для пользователя. Роль пользователя для отдельного курса может отличаться. Возможные значения: student, teacher, none, unknownFutureValue. |
| provisionedPlans | Коллекция provisionedPlan | Планы, подготовленные для пользователя. Только для чтения. Значение null не допускается. |
| refreshTokensValidFromDateTime | DateTimeOffset | Все маркеры обновления или маркеры сеансов (файлы cookie сеанса), выданные до этого времени, недопустимы, а приложения получают ошибку при использовании недопустимого маркера обновления или сеансов для получения маркера делегированного доступа (для доступа к API, таким как Microsoft Graph). В этом случае приложение должно получить новый маркер обновления, запросив авторизованную конечную точку. Возвращается только с помощью оператора $select. Только для чтения. |
| relatedContacts | коллекция relatedContact | Связанные записи, связанные с пользователем. Только для чтения. |
| residenceAddress | physicalAddress | Адрес, в котором проживает пользователь. |
| showInAddressList | Логический |
True Значение , если глобальный список адресов Outlook должен содержать этого пользователя; В противном случае — falseзначение . Если не задано, будет считаться, что присвоено значение true. Для пользователей, приглашенных через диспетчер приглашений, этому свойству присваивается значение false. |
| student | educationStudent | Если основная роль — student, этот блок будет содержать данные, касающиеся учащегося. |
| surname | String | Фамилия пользователя. Поддерживает $filter. |
| teacher | educationTeacher | Если основная роль — учитель, этот блок будет содержать данные для конкретного преподавателя. |
| usageLocation | String | Двухбуквенный код страны (по стандарту ISO 3166). Свойство необходимо указывать для пользователей, которым будут назначены лицензии, в связи с законодательным требованием проверять доступность служб в странах или регионах. Примеры: US, JP и GB. Значение null не допускается. Поддерживает $filter. |
| userPrincipalName | String | Имя участника-пользователя. Имя участника-пользователя — это имя для входа в интернет-стиле для пользователя, основанное на стандарте ИНТЕРНЕТА RFC 822. В соответствии с соглашением оно должно указывать на имя пользователя для электронной почты. Общий формат — alias@domain, где домен должен присутствовать в коллекции проверенных доменов клиента. Это свойство обязательно указывать при создании пользователя. Доступ к проверенным доменам для клиента можно получить из свойства verifiedDomainsорганизации. Поддерживает $filter и $orderby. |
| userType | String | Строковое значение, с помощью которого можно классифицировать типы пользователей в каталоге, например Member и Guest. Поддерживает $filter. |
Важно!
При использовании областей делегированных разрешений Microsoft Graph возвращает только ограниченный набор свойств: id, primaryRole, accountEnabled, displayName, givenName, surname, userPrincipalName, userType, onPremisesInfo, student/externalId, teacher/externalId. Если приложению требуются дополнительные свойства, необходимо использовать области разрешений приложения.
Связи
| Связь | Тип | Описание |
|---|---|---|
| assignments | Коллекция educationAssignment | Назначения, принадлежащие пользователю. |
| classes | Коллекция educationClass | Курсы пользователя. Допускается значение NULL. |
| schools | Коллекция educationSchool | Учебные заведения пользователя. Допускается значение null. |
| классы taughtClasses | Коллекция educationClass | Классы, для которых пользователь является преподавателем. |
| пользователь | user | Пользователь каталога, соответствующий этому пользователю. |
| Рубрики | коллекция educationRubric | Если задано значение , то к заданию прилагается рубрика оценки. |
Представление JSON
В следующем представлении JSON показан тип ресурса.
{
"@odata.type": "#microsoft.graph.educationUser",
"accountEnabled": "Boolean",
"assignedLicenses": [
{
"@odata.type": "microsoft.graph.assignedLicense"
}
],
"assignedPlans": [
{
"@odata.type": "microsoft.graph.assignedPlan"
}
],
"businessPhones": ["String"],
"createdBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"department": "String",
"displayName": "String",
"externalSource": "String",
"externalSourceDetail": "String",
"givenName": "String",
"id": "String (identifier)",
"mail": "String",
"mailingAddress": {
"@odata.type": "microsoft.graph.physicalAddress"
},
"mailNickname": "String",
"middleName": "String",
"mobilePhone": "String",
"officeLocation": "String",
"onPremisesInfo": {
"@odata.type": "microsoft.graph.educationOnPremisesInfo"
},
"passwordPolicies": "String",
"passwordProfile": {
"@odata.type": "microsoft.graph.passwordProfile"
},
"preferredLanguage": "String",
"primaryRole": "String",
"provisionedPlans": [
{
"@odata.type": "microsoft.graph.provisionedPlan"
}
],
"refreshTokensValidFromDateTime": "String (timestamp)",
"residenceAddress": {
"@odata.type": "microsoft.graph.physicalAddress"
},
"showInAddressList": "Boolean",
"student": {
"@odata.type": "microsoft.graph.educationStudent"
},
"surname": "String",
"teacher": {
"@odata.type": "microsoft.graph.educationTeacher"
},
"usageLocation": "String",
"userPrincipalName": "String",
"userType": "String"
}