命名空间：microsoft.graph
是指将任务或工作单元分配给课程中的学生或团队成员，作为其学习的一部分。
作业 包含教师希望学生处理的内容和任务。 每个学生 作业 都有一个关联的 提交， 其中包含教师要求提交的任何工作。 只有教师或团队所有者才能创建 作业。 教师可以将分数和反馈添加到学生提交的 提交 中。
创建 工作分配 时，它处于草稿状态。 学生看不到 作业，并且不会创建 提交 。 可以使用发布作更改分配的状态。 不能使用 PATCH 请求更改 分配 状态。
分配 API 在类命名空间中公开。
继承自 entity。
Methods
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 创建 | educationAssignment | 创建新 作业。 |
| Get | educationAssignment | 读取 educationAssignment 对象的属性和关系。 |
| 更新 | educationAssignment | 更新 educationAssignment 对象。 |
| 删除 | 无 | 删除 educationAssignment 对象。 |
| 发布 | educationAssignment | 将 educationAssignment 对象的状态从草稿更改为已发布。 |
| 创建作业资源 | educationAssignmentResource | 创建 工作分配资源。 |
| 获取作业资源 | educationAssignmentResource | 获取与作业关联的教育作业资源的属性。 |
| 删除分配资源 | 无 | 删除附加到作业的特定教育作业资源。 |
| 设置分配资源文件夹 | string | 在预定义的位置下创建 SharePoint 文件夹 () 以将文件作为分配资源上传。 |
| 设置分配反馈资源文件夹 | educationAssignment | 创建 SharePoint 文件夹以上传给定 educationSubmission 的反馈文件。 |
| 列出资源 | educationAssignmentResource 集合 | 获取 educationAssignmentResource 对象集合。 |
| 列出提交 | educationSubmission 集合 | 获取 educationSubmission 对象集合。 |
| List categories | educationCategory 集合 | 获取 educationCategory 对象集合。 |
| 添加类别 | educationCategory | 将属于该类的 educationCategory 分配给此作业。 |
| 删除类别 | 无 | 从此作业中删除属于该类的 educationCategory 。 |
| 附加评分 | 无 | 将现有 educationRubric 附加到此作业。 |
| 删除评分标准 | 无 | 从此作业中分离 educationRubric 。 |
| 获取增量 | educationAssignment 集合 | 获取新创建或更新的 educationAssignment 对象的列表，而无需执行集合的完整读取。 |
| 添加评分类别 | educationGradingCategory | 将 评分Category 添加到 educationAssignment。 |
| 删除评分类别 | 无 | 从 educationAssignment 中删除评分Category。 |
| 激活分配 | educationAssignment |
inactive激活 educationAssignment 以表明作业具有面向教师或学生的进一步作项。 |
| 停用分配 | educationAssignment | 将 assignededucationAssignment 标记为 inactive ，以表明作业没有针对教师和学生的进一步作项。 |
| 添加评分方案 | educationGradingScheme | 将现有 educationGradingScheme 添加到现有 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 | 工作分配的说明。 说明和显示名称告诉学生该怎么做。 |
| languageTag | String | 指定显示作业的 UI 通知时使用的语言。 如果未提供 languageTag ，则默认语言为 en-US。 可选。 |
| 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。 |
| status | educationAssignmentStatus |
工作分配的状态。 无法修补此值。 可能的值包括 draft、scheduled、published、assigned、unknownFutureValue、inactive。 使用 Prefer: include-unknown-enum-members 请求标头获取此 可演变枚举中的以下成员： inactive。 |
| webUrl | string | 给定 分配的深层链接 URL。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| 类别 | educationCategory 集合 | 设置后，用户可以轻松查找给定类型的 分配 。 只读。 可为 NULL。 |
| gradingCategory | educationGradingCategory 集合 | 设置后，用户可以在计算课堂平均成绩时以不同的方式对作业进行权重。 |
| gradingScheme | educationGradingScheme | 设置后，用户可根据此 作业获得的总积分百分比配置自定义字符串成绩。 |
| resources | educationAssignmentResource 集合 | 与此作业关联的学习对象。 只有教师可以修改此列表。 可为 Null。 |
| 量规 | educationRubric | 设置后，评分评分标准附加到此 作业。 |
| 提交 | educationSubmission 集合 | 发布后，每个学生都有一个表示其工作和成绩的 提交 对象。 只读。 可为 Null。 |
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"},
"languageTag": "String",
"lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
"lastModifiedDateTime": "String (timestamp)",
"moduleUrl": "String",
"notificationChannelUrl": "String",
"resourcesFolderUrl": "String",
"status": "String",
"webUrl": "String"
}