Поделиться через


Тип ресурса 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"
}