educationAssignment 资源类型
命名空间：microsoft.graph
是指将任务或工作单元分配给课程中的学生或团队成员，作为其学习的一部分。
只有教师或团队所有者才能创建 作业。 作业 包含教师希望学生处理的讲义和任务。 每个学生 作业 都有一个关联 的提交 ，其中包含其教师要求上交的任何工作。 教师可以向学生上交的 提交 添加分数和反馈。
创建 分配 时，它处于“草稿”状态。 学生看不到 作业 ，无法创建 提交 。 可以使用 发布操作更改 分配 的状态。 不能使用 PATCH 请求更改 分配 状态。
分配 API 在类命名空间中公开。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 创建作业资源 | educationAssignmentResource | 通过发布到资源集合来创建新的 educationAssignmentResource 。 |
| 获取作业 | educationAssignment | 读取 educationAssignment 对象的属性和关系。 |
| 更新 | educationAssignment | 更新 educationAssignment 对象。 |
| Delete | 无 | 删除 educationAssignment 对象。 |
| 发布 | educationAssignment | 将 educationAssignment 对象的状态从草稿更改为已发布。 |
| 设置工作分配资源文件夹 | string | 在预定义的位置下创建SharePoint文件夹 () 上传文件作为分配资源。 |
| 列出资源 | educationAssignmentResource 集合 | 获取 educationAssignmentResource 对象集合。 |
| 列出提交 | educationSubmission 集合 | 获取 educationSubmission 对象集合。 |
| List categories | educationCategory 集合 | 获取 educationCategory 对象集合。 |
| 添加类别 | educationCategory | 将属于该类 的 educationCategory 分配给此作业。 |
| 删除类别 | 无 | 从此作业中删除属于该类 的 educationCategory 。 |
| 附加 rubric | 无 | 将现有 educationRubric 附加到此作业。 |
| 删除 rubric | 无 | 将 educationRubric 与此作业分离。 |
| Get delta | educationAssignment 集合 | 获取新创建或更新的 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 | Who创建了 分配。 |
| createdDateTime | DateTimeOffset | 创建 分配 的那一刻。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z |
| displayName | 字符串 | 分配 的名称。 |
| dueDateTime | DateTimeOffset | 学生 作业 截止日期。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z |
| 分级 | educationAssignmentGradeType | 如何对 分配 进行分级。 |
| 指示 | itemBody | 有关分配的说明。 这连同显示名称一起告诉学生该怎么做。 |
| lastModifiedBy | identitySet | Who上次修改 分配。 |
| 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 集合 | Learning与此分配关联的对象。 只有教师才能修改此列表。 可为 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"
}
反馈
提交和查看相关反馈