educationSubmission:重新分配
命名空间:microsoft.graph
重要
Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
将 提交重新 分配给学生并反馈评价。
只有教师才能执行此操作。
Prefer: include-unknown-enum-members调用此方法时包含 标头;否则,重新分配的提交将被视为返回的提交。 这意味着状态将reassigned``returned映射到状态,reassignedDateTime 和 reassignedBy 属性将分别映射到 returnedDateTime 和 returnedBy。
如果提供了标头 Prefer: include-unknown-enum-members ,则重新分配的提交将保留状态 reassigned 。 有关详细信息,请参阅示例部分。
权限
要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限。
| 权限类型 | 权限(从最低特权到最高特权) |
|---|---|
| 委派(工作或学校帐户) | EduAssignments.ReadWriteBasic、EduAssignments.ReadWrite |
| 委派(个人 Microsoft 帐户) | 不支持。 |
| 应用程序 | 不支持。 |
HTTP 请求
POST /education/classes/{id}/assignments/{id}/submissions/{id}/reassign
请求标头
| 标头 | 值 |
|---|---|
| Authorization | Bearer {token}。必需。 |
| Prefer | include-unknown-enum-members. 可选。 |
请求正文
请勿提供此方法的请求正文。
响应
如果成功,此方法在响应 200 OK 正文中返回 响应代码和 educationSubmission 对象。
示例
示例 1:没有可选首选标头的请求
请求
下面展示了示例请求。
POST /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/02bb5de1-7205-2a25-fe33-f99cf53de1c4/reassign
响应
下面是请求标头 Prefer: include-unknown-enum-members 中未提供且之前未返回提交时的响应示例。
HTTP/1.1 200 OK
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission",
"@odata.type": "#microsoft.graph.educationSubmission",
"status": "returned",
"submittedDateTime": "2021-09-07T14:54:46.1606962Z",
"unsubmittedDateTime": "2021-09-07T14:41:18.9512645Z",
"returnedDateTime": "2021-09-07T21:38:40.5254847Z",
"reassignedDateTime": "2021-09-07T21:38:40.5254847Z",
"resourcesFolderUrl": null,
"id": "02bb5de1-7205-2a25-fe33-f99cf53de1c4",
"recipient": {
"@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
"userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
},
"submittedBy": {
"application": null,
"device": null,
"user": {
"id": "80cefd93-8d88-40e2-b5d3-67898383e226",
"displayName": null
}
},
"unsubmittedBy": {
"application": null,
"device": null,
"user": {
"id": "80cefd93-8d88-40e2-b5d3-67898383e226",
"displayName": null
}
},
"returnedBy": {
"application": null,
"device": null,
"user": {
"id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
"displayName": null
}
},
"reassignedBy": {
"application": null,
"device": null,
"user": {
"id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
"displayName": null
}
}
}
示例 2:具有 Prefer 标头的请求
以下示例演示如何调用此方法。
请求
下面展示了示例请求。
POST /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/02bb5de1-7205-2a25-fe33-f99cf53de1c4/reassign
Prefer: include-unknown-enum-members
响应
下面是请求标头中提供 Prefer: include-unknown-enum-members 且之前未返回提交时的响应示例。
HTTP/1.1 200 OK
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission",
"@odata.type": "#microsoft.graph.educationSubmission",
"status": "reassigned",
"submittedDateTime": "2021-09-07T21:44:41.8377109Z",
"unsubmittedDateTime": "2021-09-07T14:41:18.9512645Z",
"returnedDateTime": null,
"reassignedDateTime": "2021-09-07T21:45:42.9027726Z",
"resourcesFolderUrl": null,
"id": "02bb5de1-7205-2a25-fe33-f99cf53de1c4",
"recipient": {
"@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
"userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
},
"submittedBy": {
"application": null,
"device": null,
"user": {
"id": "80cefd93-8d88-40e2-b5d3-67898383e226",
"displayName": null
}
},
"unsubmittedBy": {
"application": null,
"device": null,
"user": {
"id": "80cefd93-8d88-40e2-b5d3-67898383e226",
"displayName": null
}
},
"returnedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
},
"reassignedBy": {
"application": null,
"device": null,
"user": {
"id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
"displayName": null
}
}
}
另请参阅
反馈
提交和查看相关反馈