educationAssignment 资源类型

项目
06/05/2022

命名空间：microsoft.graph

重要

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

是指将任务或工作单元分配给课程中的学生或团队成员，作为其学习的一部分。

只有教师或团队所有者才能创建作业。作业包含教师希望学生处理的讲义和任务。每个学生作业都有一个关联的提交，其中包含其教师要求上交的任何工作。教师可以向学生上交的提交添加分数和反馈。

创建分配时，它处于“草稿”状态。学生看不到作业，无法创建提交。可以使用发布操作更改分配的状态。不能使用 PATCH 请求更改分配状态。

分配 API 在类命名空间中公开。

方法

方法	返回类型	说明
创建作业资源	educationAssignmentResource	通过发布到资源集合来创建新的 educationAssignmentResource 。
获取作业	educationAssignment	读取 educationAssignment 对象的属性和关系。
更新	educationAssignment	更新 educationAssignment 对象。
删除	无	删除 educationAssignment 对象。
发布	educationAssignment	将 educationAssignment 对象的状态从草稿更改为已发布。
设置工作分配资源文件夹	string	在预定义的位置) 下创建 SharePoint 文件夹 (以将文件作为分配资源上传。
设置工作分配反馈资源文件夹	educationAssignment	创建 SharePoint 文件夹以上传给定 educationSubmission 的反馈文件。
列出资源	educationAssignmentResource 集合	获取 educationAssignmentResource 对象集合。
列出提交	educationSubmission 集合	获取 educationSubmission 对象集合。
List categories	educationCategory 集合	获取 educationCategory 对象集合。
添加类别	educationCategory	将属于该类的 educationCategory 分配给此作业。
删除类别	无	从此作业中删除属于该类的 educationCategory。
附加 rubric	无	将现有 educationRubric 附加到此作业。
删除 rubric	无	将 educationRubric 与此作业分离。
Get delta	educationAssignment 集合	获取新创建或更新的分配的列表，而无需对集合执行完整读取。

属性

属性	类型	说明
id	String	只读。
addedStudentAction	String	用于控制在作业发布后添加的学生的作业行为的可选字段。如果未指定，则 `none` 默认为值。目前仅支持两个值： `none` 或 `assignIfOpen`。
addToCalendarAction	educationAddToCalendarOptions	用于控制在作业发布时将作业添加到学生和教师日历的作业行为的可选字段。可能的值是： `none`、 `studentsAndPublisher`、 `studentsAndTeamOwners`、 `unknownFutureValue`和 `studentsOnly`。请注意，必须使用`Prefer: include-unknown-enum-members`请求标头获取以下值 (此可旋转枚举中的) ： `studentsOnly` 默认值为 `none`。
allowLateSubmissions	Boolean	标识学生是否可以在截止日期后提交。如果在创建过程中未指定此属性，则默认为 true。
allowStudentsToAddResourcesToSubmission	Boolean	确定学生是否可以将自己的资源添加到提交中，或者是否只能修改教师添加的资源。
assignDateTime	DateTimeOffset	分配应处于活动状态的日期。如果将来，直到此日期才会向学生显示作业。时间戳类型表示使用 ISO 8601 格式的日期和时间信息，并且始终采用 UTC 时间。例如，2014 年 1 月 1 日午夜 UTC 为 `2014-01-01T00:00:00Z`
assignTo	educationAssignmentRecipient	发布分配后，哪些用户或整个类应接收提交对象。
assignedDateTime	DateTimeOffset	作业发布给学生的那一刻，作业显示在学生日程表上。时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。例如，2014 年 1 月 1 日午夜 UTC 为 `2014-01-01T00:00:00Z`
classId	String	此分配所属的类。
closeDateTime	DateTimeOffset	将关闭分配以供提交的日期。如果分配不允许LateSubmissions或 closeDateTime 与 dueDateTime 相同，则此字段可以为 null。但如果指定，则 closeDateTime 必须大于或等于 dueDateTime。时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。例如，2014 年 1 月 1 日午夜 UTC 为 `2014-01-01T00:00:00Z`
createdBy	identitySet	创建分配的人员。
createdDateTime	DateTimeOffset	创建分配的那一刻。时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。例如，2014 年 1 月 1 日午夜 UTC 为 `2014-01-01T00:00:00Z`
displayName	String	分配的名称。
dueDateTime	DateTimeOffset	学生作业截止日期。时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。例如，2014 年 1 月 1 日午夜 UTC 为 `2014-01-01T00:00:00Z`
feedbackResourcesFolderUrl	String	存储此分配的所有反馈文件资源的文件夹 URL。
分级	educationAssignmentGradeType	如何对分配进行分级。
指示	itemBody	有关分配的说明。这连同显示名称一起告诉学生该怎么做。
lastModifiedBy	identitySet	上次修改分配的人员。
lastModifiedDateTime	DateTimeOffset	上次修改分配的那一刻。时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。例如，2014 年 1 月 1 日午夜 UTC 为 `2014-01-01T00:00:00Z`
notificationChannelUrl	String	用于指定用于发布分配发布通知的通道的 URL 的可选字段。如果未指定或为 null，则 `General` 默认为通道。此字段仅适用于 assignTo 值为 educationAssignmentClassRecipient 的作业。发布分配后，不允许更新 notificationChannelUrl。
状态	string	工作分配的状态。无法修补此值。可能的值是：`draft`、`scheduled`、`published`、`assigned`。
WebUrl	string	给定分配的深层链接 URL。
resourcesFolderUrl	string	存储此分配的所有文件资源的文件夹 URL。

关系

关系	类型	说明
resources	educationAssignmentResource 集合	学习与此分配关联的对象。只有教师才能修改此列表。可为 Null。
提交	educationSubmission 集合	发布后，每个表示其工作和成绩的学生都有一个提交对象。只读。可为 Null。
类别	educationCategory 集合	设置后，用户可以轻松查找给定类型的分配。只读。可为 Null。
量规	educationRubric	设置后，附加到此分配的分级红标。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "id": "String (identifier)",
  "addedStudentAction": "none",
  "addToCalendarAction": "string",
  "allowLateSubmissions": true,
  "allowStudentsToAddResourcesToSubmission": true,
  "assignDateTime": "String (timestamp)",
  "assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"},
  "assignedDateTime": "String (timestamp)",
  "classId": "String",
  "closeDateTime": "String (timestamp)",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "displayName": "String",
  "dueDateTime": "String (timestamp)",
  "grading": {"@odata.type": "microsoft.graph.educationAssignmentGradeType"},
  "instructions": {"@odata.type": "microsoft.graph.itemBody"},
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "notificationChannelUrl": "string",
  "status": "string",
  "webUrl": "string",
  "resourcesFolderUrl": "string"
}