educationClass: getRecentlyModifiedSubmissions
Пространство имен: microsoft.graph
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Получение отправок, измененных за предыдущие семь дней. Эту операцию могут выполнять только преподаватели и приложения с разрешениями приложений.
Объект отправки представляет работу учащегося для задания. Ресурсы, связанные с отправкой, представляют свою работу.
Преподаватель или приложение с разрешениями приложения имеет полный доступ ко всем объектам отправки .
Оценка и отзыв преподавателя являются частью educationOutcome, связанного с этим объектом. Добавлять или изменять оценки и отзывы могут только преподаватели или приложения с разрешениями приложений. Учащиеся не смогут увидеть оценку или отзыв до тех пор, пока задание не будет освобождено.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | EduAssignments.Read | EduAssignments.ReadWrite |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Приложение | EduAssignments.Read.All | EduAssignments.ReadWrite.All |
HTTP-запрос
GET /education/classes/{class-id}/getRecentlyModifiedSubmissions
Необязательные параметры запросов
Этот метод поддерживает $orderby
параметры запроса , $top
, $filter
, $select
и $expand
OData для настройки ответа. Общие сведения см. в статье Параметры запроса OData.
Параметр $orderby
запроса поддерживает только свойство lastModifiedDateTime ресурса educationSubmission .
Порядок по умолчанию выполняется путем убывания значений свойств lastModifiedDateTime .
Заголовки запросов
Заголовок | Значение |
---|---|
Авторизация | Bearer {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
параметрами и $filter
для свойства assignmentId
Запрос
Ниже показан пример запроса.
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. Получение недавно измененных отправок с $filter
параметром для диапазона в свойстве lastModifiedDateTime
Запрос
Ниже показан пример запроса.
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
}
}
}
]
}