Тип ресурса educationUser

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

Пользователь в системе. Это зависящий от образования вариант пользователя с тем же идентификатором , который Microsoft Graph будет возвращать из конечной точки, отличной /users от образования. Этот объект предоставляет целевое подмножество свойств из основного объекта пользователя и добавляет набор свойств, относящихся к образованию, таких как данные primaryRole, student и teacher .

Наследует от сущности.

Методы

Метод	Тип возвращаемых данных	Описание
Список	Коллекция educationUser	Получите список объектов educationUser и их свойств.
Создание	educationUser	Создайте новый объект educationUser .
Получение	educationUser	Чтение свойств и связей объекта educationUser .
Обновление	educationUser	Обновление свойств объекта educationUser .
Delete	Нет	Удаление объекта 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"
}