educationClass:getRecentlyModifiedSubmissions
命名空间:microsoft.graph
重要
Microsoft Graph /beta
版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
检索在前七天内修改的提交。 只有具有应用程序权限的教师和应用程序才能执行此操作。
提交对象表示学生的作业。 与提交关联的资源表示其工作。
具有应用程序权限的教师或应用程序对所有 提交 对象具有完全访问权限。
教师的成绩和反馈是与此对象关联的 educationOutcome 的一部分。 只有具有应用程序权限的教师或应用程序才能添加或更改成绩和反馈。 在 作业 发布之前,学生无法查看成绩或反馈。
此 API 可用于以下国家级云部署。
全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
权限类型 | 最低特权权限 | 更高特权权限 |
---|---|---|
委派(工作或学校帐户) | EduAssignments.Read | EduAssignments.ReadWrite |
委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
应用程序 | EduAssignments.Read.All | EduAssignments.ReadWrite.All |
HTTP 请求
GET /education/classes/{class-id}/getRecentlyModifiedSubmissions
可选的查询参数
此方法支持 $orderby
、$top
、、 $filter
$select
和 $expand
OData 查询参数,以帮助自定义响应。 若要了解一般信息,请参阅 OData 查询参数。
查询$orderby
参数仅支持 educationSubmission 资源的 lastModifiedDateTime 属性。
默认顺序为 lastModifiedDateTime 属性值降序。
请求标头
标头 | 值 |
---|---|
Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
请求正文
请勿提供此方法的请求正文。
响应
如果成功,此方法在响应正文中返回响应 200 OK
代码和 educationSubmission 对象集合。
如果为 $orderby
查询参数指定了不支持的属性,该方法将返回一 400
条错误消息。
HTTP/1.1 400 Bad Request
Content-type: application/json
{
"error": {
"code": "20143",
"message": "The OData query is invalid. $orderby clause is only supported for these properties : (lastModifiedDateTime).",
"innerError": {
"date": "2024-08-27T13:04:10",
"request-id": "218ae0dc-664c-4928-b4e1-f3b37c27c472",
"client-request-id": "ed8c66ed-fd50-d7ec-d989-5a92140999c1"
}
}
}
如果为 $filter
查询参数指定了不支持的值,该方法将返回一 400
条错误消息。
HTTP/1.1 400 Bad Request
Content-type: application/json
{
"error": {
"code": "BadRequest",
"message": "Invalid filter clause: The $filter expression must evaluate to a single boolean value.",
"innerError": {
"date": "2024-08-27T13:05:11",
"request-id": "31233bf3-c442-4a8d-a1ff-56c665239e25",
"client-request-id": "30f9e18f-f311-741b-bf48-23fd4feecdb9"
}
}
}
示例
示例 1:获取最近修改的提交
请求
以下示例显示了一个请求。
GET https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/getRecentlyModifiedSubmissions
响应
以下示例显示了相应的响应。
注意:为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)",
"@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET education/classes('<guid>')/microsoft.graph.getRecentlyModifiedSubmissions?$select=excusedBy,excusedDateTime",
"value": [
{
"status": "returned",
"submittedDateTime": null,
"unsubmittedDateTime": "2024-08-14T05:48:30.9345815Z",
"returnedDateTime": "2024-08-14T05:47:41.4128921Z",
"reassignedDateTime": "2024-08-14T05:47:18.3007671Z",
"excusedDateTime": "2024-08-14T05:47:41.4128921Z",
"lastModifiedDateTime": "2024-08-14T06:37:17.9779374Z",
"resourcesFolderUrl": null,
"webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%22bf1f1963-05f6-4cba-903c-5892b4ce3bd7%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%22db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%224bca096a-7de3-8675-5e86-2fa149923860%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D",
"id": "4bca096a-7de3-8675-5e86-2fa149923860",
"recipient": {
"@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
"userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
},
"submittedBy": {
"application": null,
"device": null,
"user": {
"id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null
}
},
"unsubmittedBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
},
"returnedBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
},
"reassignedBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
},
"excusedBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
},
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
}
}
]
}
示例 2:使用 $select
assignmentId 属性上的 和 $filter
选项获取最近修改的提交
请求
以下示例显示了一个请求。
GET https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/getrecentlymodifiedsubmissions?$filter=assignmentId eq 'b20d6737-f88e-4892-8174-73aa26d18784'&$select=LastModifiedDateTime,status
响应
以下示例显示了相应的响应。
注意:为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)",
"value": [
{
"status": "submitted",
"lastModifiedDateTime": "2024-09-09T10:18:33.4052415Z"
},
{
"status": "working",
"lastModifiedDateTime": "2024-09-09T10:18:07.6464644Z"
},
{
"status": "working",
"lastModifiedDateTime": "2024-09-09T10:18:07.588738Z"
},
{
"status": "working",
"lastModifiedDateTime": "2024-09-09T10:18:07.5295878Z"
},
{
"status": "working",
"lastModifiedDateTime": "2024-09-09T10:18:07.4718648Z"
},
{
"status": "working",
"lastModifiedDateTime": "2024-09-09T10:18:07.3513158Z"
},
{
"status": "working",
"lastModifiedDateTime": "2024-09-09T10:18:07.2866527Z"
},
{
"status": "working",
"lastModifiedDateTime": "2024-09-09T10:18:07.2219998Z"
},
{
"status": "working",
"lastModifiedDateTime": "2024-09-09T10:18:07.1602788Z"
},
{
"status": "working",
"lastModifiedDateTime": "2024-09-09T10:18:07.0884058Z"
}
]
}
示例 3:使用 $expand
选项获取最近修改的提交
请求
以下示例显示了一个请求。
GET https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/getRecentlyModifiedSubmissions?$expand=outcomes
响应
以下示例显示了相应的响应。
注意:为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)",
"@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET education/classes('<guid>')/microsoft.graph.getRecentlyModifiedSubmissions?$select=excusedBy,excusedDateTime",
"value": [
{
"status": "working",
"submittedDateTime": null,
"unsubmittedDateTime": null,
"returnedDateTime": null,
"reassignedDateTime": null,
"excusedDateTime": null,
"lastModifiedDateTime": "2024-08-26T20:45:51.3485047Z",
"resourcesFolderUrl": null,
"webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%2237d99af7-cfc5-4e3b-8566-f7d40e4a2070%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%2273b252e5-5f2c-42d6-8896-bfe924ce5fe9%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%225af42a11-37cc-c144-fa4c-7db855942011%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D",
"id": "5af42a11-37cc-c144-fa4c-7db855942011",
"recipient": {
"@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
"userId": "e5c17181-ad7e-4a66-86bf-b560ce0c8b29"
},
"submittedBy": {
"application": null,
"device": null,
"user": {
"id": "e5c17181-ad7e-4a66-86bf-b560ce0c8b29",
"displayName": null
}
},
"unsubmittedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
},
"returnedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
},
"reassignedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
},
"excusedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
},
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "7254e396-868c-4bf7-96b2-6fe763590b5a",
"displayName": null
}
},
"outcomes": [
{
"@odata.type": "#microsoft.graph.educationFeedbackOutcome",
"lastModifiedDateTime": null,
"id": "ca05367a-b292-42d5-aff7-5d279feeace8",
"lastModifiedBy": null,
"feedback": null,
"publishedFeedback": null
},
{
"@odata.type": "#microsoft.graph.educationPointsOutcome",
"lastModifiedDateTime": null,
"id": "ea1351f6-ba33-4940-b2cb-6a7254af2dc8",
"lastModifiedBy": null,
"points": null,
"publishedPoints": null
}
]
}
]
}
示例 4:使用 $filter
选项获取最近修改的提交
请求
以下示例显示了一个请求。
GET https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/getRecentlyModifiedSubmissions?$filter=status eq 'working'
响应
以下示例显示了相应的响应。
注意:为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)",
"@odata.nextLink": "https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/getRecentlyModifiedSubmissions?$filter=status+eq+%27working%27&$skiptoken=eyJJbm5lclNraXBUb2tlbiI6Ik15WlJWa1pDVVZWR1FsRlZSa1phTVd4Q1VWVkdRbEZWUmtKU1JXeENVVlZHUWxWWFZscE9SM040U3pCc1RGWlRjM2RTTUhkNlZGVlJlRlJzUW1oa2VqQTUifQ%3d%3d",
"@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET education/classes('<guid>')/microsoft.graph.getRecentlyModifiedSubmissions?$select=excusedBy,excusedDateTime",
"value": [
{
"status": "working",
"submittedDateTime": null,
"unsubmittedDateTime": null,
"returnedDateTime": null,
"reassignedDateTime": null,
"excusedDateTime": null,
"lastModifiedDateTime": "2024-08-26T15:57:23.5476513Z",
"resourcesFolderUrl": null,
"webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%2237d99af7-cfc5-4e3b-8566-f7d40e4a2070%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%223d2fcfd4-cb6a-4e31-aa63-16ca865e9014%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%227e2e0656-2bf4-1f95-b4b0-967f516340cd%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D",
"id": "7e2e0656-2bf4-1f95-b4b0-967f516340cd",
"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": null,
"displayName": null
}
},
"returnedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
},
"reassignedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
},
"excusedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
},
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "5e3ce6c0-2b1f-4285-8d4b-75ee78787346",
"displayName": null
}
}
}
]
}
示例 5:使用 $orderby
和 $top
选项获取最近修改的提交
请求
以下示例显示了一个请求。
GET https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/getRecentlyModifiedSubmissions?$orderby=lastModifiedDateTime&$top=1
响应
以下示例显示了相应的响应。
注意:为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)",
"@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET education/classes('<guid>')/microsoft.graph.getRecentlyModifiedSubmissions?$select=excusedBy,excusedDateTime",
"value": [
{
"status": "working",
"submittedDateTime": null,
"unsubmittedDateTime": null,
"returnedDateTime": null,
"reassignedDateTime": null,
"excusedDateTime": null,
"lastModifiedDateTime": "2024-08-26T15:57:23.2992323Z",
"resourcesFolderUrl": null,
"webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%2237d99af7-cfc5-4e3b-8566-f7d40e4a2070%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%223d2fcfd4-cb6a-4e31-aa63-16ca865e9014%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%223b03a85c-6021-8e5c-fc07-c4ac6d3506d3%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D",
"id": "3b03a85c-6021-8e5c-fc07-c4ac6d3506d3",
"recipient": {
"@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
"userId": "2d20b7fc-43bd-459c-81e0-5eb4aa20d5b5"
},
"submittedBy": {
"application": null,
"device": null,
"user": {
"id": "2d20b7fc-43bd-459c-81e0-5eb4aa20d5b5",
"displayName": null
}
},
"unsubmittedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
},
"returnedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
},
"reassignedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
},
"excusedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
},
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "5e3ce6c0-2b1f-4285-8d4b-75ee78787346",
"displayName": null
}
}
}
]
}
示例 6:使用 $select
选项获取最近修改的提交
请求
以下示例显示了一个请求。
GET https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/getRecentlyModifiedSubmissions?$select=excusedDateTime
响应
以下示例显示了相应的响应。
注意:为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)",
"value": [
{
"excusedDateTime": "2024-08-26T16:00:17.535348Z"
},
{
"excusedDateTime": "2024-08-26T16:00:17.4698345Z"
},
{
"excusedDateTime": null
}
]
}
示例 7:使用 lastModifiedDateTime 属性上的范围选项获取最近修改的提交$filter
请求
以下示例显示了一个请求。
GET https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/getRecentlyModifiedSubmissions?$filter=lastModifiedDateTime gt 2024-08-25T20:45:51.3485047Z and lastModifiedDateTime lt 2024-08-28T20:45:51.3485047Z
响应
以下示例显示了相应的响应。
注意:为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)",
"@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET education/classes('<guid>')/microsoft.graph.getRecentlyModifiedSubmissions?$select=excusedBy,excusedDateTime",
"value": [
{
"status": "working",
"submittedDateTime": null,
"unsubmittedDateTime": null,
"returnedDateTime": null,
"reassignedDateTime": null,
"excusedDateTime": null,
"lastModifiedDateTime": "2024-08-26T20:45:51.3485047Z",
"resourcesFolderUrl": null,
"webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%2237d99af7-cfc5-4e3b-8566-f7d40e4a2070%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%2273b252e5-5f2c-42d6-8896-bfe924ce5fe9%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%225af42a11-37cc-c144-fa4c-7db855942011%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D",
"id": "5af42a11-37cc-c144-fa4c-7db855942011",
"recipient": {
"@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
"userId": "e5c17181-ad7e-4a66-86bf-b560ce0c8b29"
},
"submittedBy": {
"application": null,
"device": null,
"user": {
"id": "e5c17181-ad7e-4a66-86bf-b560ce0c8b29",
"displayName": null
}
},
"unsubmittedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
},
"returnedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
},
"reassignedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
},
"excusedBy": {
"application": null,
"device": null,
"user": {
"id": null,
"displayName": null
}
},
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "7254e396-868c-4bf7-96b2-6fe763590b5a",
"displayName": null
}
}
}
]
}