educationAssignment 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
是指将任务或工作单元分配给课程中的学生或团队成员，作为其学习的一部分。
作业 包含教师希望学生处理的内容和任务。 每个学生 作业 都有一个关联的 提交， 其中包含教师要求提交的任何工作。 只有教师或团队所有者才能创建 作业。 教师可以将分数和反馈添加到学生提交的 提交 中。
创建 工作分配 时，它处于草稿状态。 学生看不到 作业，并且不会创建 提交 。 可以使用发布操作更改分配的状态。 不能使用 PATCH 请求更改 分配 状态。
分配 API 在类命名空间中公开。
继承自 entity。
Methods
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 创建作业资源 | educationAssignmentResource | 通过发布到资源集合来创建新的 educationAssignmentResource 。 |
| 获取作业 | educationAssignment | 读取 educationAssignment 对象的属性和关系。 |
| 更新 | educationAssignment | 更新 educationAssignment 对象。 |
| 删除 | None | 删除 educationAssignment 对象。 |
| 发布 | educationAssignment | 将 educationAssignment 对象的状态从草稿更改为已发布。 |
| 设置分配资源文件夹 | string | 在预定义的位置下创建 SharePoint 文件夹 () 以将文件作为分配资源上传。 |
| 设置分配反馈资源文件夹 | educationAssignment | 创建 SharePoint 文件夹以上传给定 educationSubmission 的反馈文件。 |
| 列出资源 | educationAssignmentResource 集合 | 获取 educationAssignmentResource 对象集合。 |
| 列出提交 | educationSubmission 集合 | 获取 educationSubmission 对象集合。 |
| List categories | educationCategory 集合 | 获取 educationCategory 对象集合。 |
| 添加类别 | educationCategory | 将属于该类的 educationCategory 分配给此作业。 |
| 删除类别 | None | 从此作业中删除属于该类的 educationCategory。 |
| 附加评分 | None | 将现有 educationRubric 附加到此 作业。 |
| 删除评分标准 | None | 从此作业中分离 educationRubric。 |
| 获取增量 | educationAssignment 集合 | 获取新创建或更新 的分配 的列表，而无需执行集合的完整读取。 |
| 添加 educationGradingCategory | educationGradingCategory | 通过发布到评分类别集合来添加评分Category。 |
| 删除 educationGradingCategory | None | 删除 educationGradingCategory 对象。 |
| 激活分配 | educationAssignment | 激活非活动 教育分配 ，以指示作业包含教师或学生的进一步操作项。 |
| 停用分配 | educationAssignment | 将分配 的 educationAssignment 标记为非活动状态，以表明该作业没有针对教师和学生的进一步操作项。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| addedStudentAction | String | 可选字段，用于控制在 作业 发布后添加的学生的 作业 行为。 如果未指定，则默认为 none。 支持的值为： none、 assignIfOpen。 例如，教师可以使用 assignIfOpen 指示应将作业分配给在作业仍处于打开状态时加入课堂的任何新学生，以及 none 指示不应将作业分配给新学生。 |
| addToCalendarAction | educationAddToCalendarOptions | 可选字段，用于控制作业在发布 作业 时将 作业 添加到学生和教师日历的 作业 行为。 可能的值为：none、、studentsAndPublisherstudentsAndTeamOwners、unknownFutureValue、 和 studentsOnly。 使用 Prefer: include-unknown-enum-members 请求标头获取以下值， (此 可演变枚举中的) ： studentsOnly。 默认值为 none。 |
| allowLateSubmissions | 布尔值 | 标识学生是否可以在截止日期后提交。 如果在创建过程中未指定此属性，则默认为 true。 |
| allowStudentsToAddResourcesToSubmission | 布尔值 | 标识学生是否可以将自己的资源添加到 提交 中，或者他们是否只能修改教师添加的资源。 |
| 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 | 作业的评分方式。 |
| id | String | 工作分配的唯一标识符。 继承自 entity。 只读。 |
| 指示 | itemBody | 工作分配的说明。 此属性和显示名称告知学生要执行的操作。 |
| lastModifiedBy | identitySet | 上次修改 作业的人员。 |
| lastModifiedDateTime | DateTimeOffset | 修改 工作分配 的日期和时间。 学生提交不会修改作业;只有教师才能更新作业。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z |
| moduleUrl | string | 从中访问 分配的模块的 URL。 |
| notificationChannelUrl | String | 可选字段，用于指定用于发布分配发布通知的通道的 URL。 如果未指定或 null，则默认为 General 通道。 此字段仅适用于 assignTo 值为 educationAssignmentClassRecipient 的作业。 发布分配后，不允许更新 notificationChannelUrl。 |
| resourcesFolderUrl | string | 存储此 分配 的所有文件资源的文件夹 URL。 |
| 状态 | string |
工作分配的状态。 无法修补此值。 可取值为：draft、scheduled、published、assigned、unknownFutureValue、inactive。 使用 Prefer: include-unknown-enum-members 请求标头获取以下值， (此 可演变枚举中的) ： inactive。 |
| webUrl | string | 给定 分配的深层链接 URL。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| resources | educationAssignmentResource 集合 | 与此 作业关联的学习对象。 只有教师可以修改此列表。 可为 Null。 |
| 提交 | educationSubmission 集合 | 发布后，每个学生都有一个 提交 对象，表示其工作和成绩。 只读。 可为 NULL。 |
| 类别 | educationCategory 集合 | 设置后，用户可以轻松查找给定类型的 分配 。 只读。 可为 Null。 |
| 量规 | educationRubric | 设置后，评分评分标准附加到此 作业。 |
| gradingCategory | educationGradingCategory 集合 | 设置后，用户可以在计算课堂平均成绩时以不同的方式对作业进行权重。 |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"addedStudentAction": "String",
"addToCalendarAction": "String",
"allowLateSubmissions": "Boolean",
"allowStudentsToAddResourcesToSubmission": "Boolean",
"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)",
"feedbackResourcesFolderUrl": "String",
"grading": {"@odata.type": "microsoft.graph.educationAssignmentGradeType"},
"id": "String (identifier)",
"instructions": {"@odata.type": "microsoft.graph.itemBody"},
"lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
"lastModifiedDateTime": "String (timestamp)",
"moduleUrl": "String",
"notificationChannelUrl": "String",
"resourcesFolderUrl": "String",
"status": "String",
"webUrl": "String"
}