educationUser 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

系统中的用户。 此资源是标准 用户 资源的特定于教育的变体，与 id Microsoft Graph 从非教育特定的 /users 终结点返回的相同。

此对象提供核心 用户 对象中的属性的目标子集，并添加一组特定于教育的属性，例如 primaryRole、 student和 teacher。

方法

方法	返回类型	说明
Get educationUser	educationUser	读取 educationUser 对象的属性和关系。
List classes	educationClass 集合	获取 educationClass 对象集合，用户是该集合的成员。
List schools	educationSchool 集合	获取 educationSchool 对象集合，用户是该集合的成员。
Get user	user	获取与此 educationUser 对应的简单目录 user。
Update	educationUser	更新 educationUser 对象。
Delete	无	删除 educationUser 对象。
Delta	educationUser 集合	获取 educationUsers 的增量更改。

属性

属性	类型	说明
id	String	用户的唯一标识符。 继承自 directoryObject。 键。 不可为 null。 只读。
accountEnabled	Boolean	如果帐户已启用，则为 true；否则，为 false。 创建用户时此属性是必需的。 支持 $filter。
assignedLicenses	assignedLicense collection	分配给该用户的许可证。 不可为 null。
assignedPlans	assignedPlan collection	分配给该用户的计划。 只读。 不可为 null。
businessPhones	String collection	用户的电话号码。 注意：虽然这是字符串集合，但是只能为该属性设置一个号码。
createdBy	identitySet	创建了用户的实体。
department	String	用户工作部门的名称。 支持 $filter。
displayName	String	用户通讯簿中显示的名称。 支持 $filter 和 $orderby。
externalSource	String	此资源从 (从) 自动生成 externalSourceDetail 的外部源类型。 可能的值为： sis、 lms或 manual。
externalSourceDetail	String	从中生成此资源的外部源的名称。
givenName	String	用户的名。 支持 $filter。
邮件	String	用户的 SMTP 地址;例如，“jeff@contoso.com”。 只读。 支持 $filter。
mailNickname	String	用户的邮件别名。 创建用户时必须指定此属性。 支持 $filter。
mailingAddress	physicalAddress	用户的邮件地址。 注意：type资源不支持 educationUser 和 postOfficeBox 。
middleName	String	用户的中间名。
mobilePhone	String	用户的主要移动电话号码。
onPremisesInfo	educationOnPremisesInfo	用于将Microsoft Entra用户与其 Active Directory 对应项关联的其他信息。
passwordPolicies	String	指定用户的密码策略。 有关更多详细信息，请参阅标准 用户 资源。
passwordProfile	passwordProfile	指定用户的密码配置文件。 配置文件包含用户的密码。 创建用户时此属性是必需的。 有关更多详细信息，请参阅标准 用户 资源。
preferredLanguage	String	用户的首选语言。 应遵循 ISO 639-1 代码；例如“en-US”。
primaryRole	string	用户的默认角色。 用户的角色在各课程中可能有所不同。 可取值为：student、teacher、faculty。 支持 $filter。
provisionedPlans	provisionedPlan 集合	为用户设置的计划。 只读。 不可为 null。
relatedContacts	relatedContact 集合	与用户相关的相关记录。 可能的关系包括 parent、、relative、aide、doctorguardianchild、、other、unknownFutureValue
residenceAddress	physicalAddress	用户所在的地址。 注意：type资源不支持 educationUser 和 postOfficeBox 。
student	educationStudent	如果主要角色是学生，则此块包含特定于学生的数据。
surname	String	用户的姓氏。 支持 $filter。
teacher	educationTeacher	如果主要角色是教师，则此块将包含教师特定的数据。
usageLocation	String	ISO 3166 Alpha-2) (双字母国家/地区代码。 对于将分配许可证的用户是必需的。 不可为 null。 支持 $filter。
userPrincipalName	String	用户主体名称 (UPN) 。 支持 $filter 和 $orderby。 有关更多详细信息，请参阅标准 用户 资源。
userType	String	可用于对目录中的用户类型分类的字符串值，例如“成员”和“访客”。 支持 $filter。

重要

使用委托的权限范围时，Graph 将仅返回一组有限的属性：id、、primaryRole、accountEnabled、displayNamegivenName、surname、userPrincipalName、userTypeonPremisesInfo、student/externalId、、 。 teacher/externalId 如果应用程序需要其他属性，则必须使用应用程序权限范围。

关系

关系	类型	说明
assignments	educationAssignment	用户的分配列表。 可为 NULL。
classes	educationClass 集合	用户所属的课程。 可为 NULL。
schools	educationSchool 集合	用户所属的学校。 可为 NULL。
taughtClasses	educationClass 集合	用户是教师的类。
评分标准	educationRubric 集合	设置后，评分评分标准会附加到作业。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "accountEnabled": true,
  "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",
  "givenName": "String",
  "id": "String (identifier)",
  "mail": "String",
  "mailNickname": "String",
  "mailingAddress": { "@odata.type": "microsoft.graph.physicalAddress" },
  "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" }],
  "residenceAddress": { "@odata.type": "microsoft.graph.physicalAddress" },
  "student": { "@odata.type": "microsoft.graph.educationStudent" },
  "surname": "String",
  "teacher": { "@odata.type": "microsoft.graph.educationTeacher" },
  "usageLocation": "String",
  "userPrincipalName": "String",
  "userType": "String"
}