次の方法で共有


educationSubmission を取得する

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

特定の申請を取得 します。 この操作を実行できるのは、アプリケーションのアクセス許可を持つ教師、学生、アプリケーションだけです。

申請オブジェクトは、課題に対する学生の作業を表します。 申請に関連付けられているリソースは、この作業を表します。

提出物を表示および変更できるのは、assignedTo 学生だけです。 アプリケーションのアクセス許可を持つ教師またはアプリケーションは、すべての申請にフル アクセス できます

教師からの成績とフィードバックは、このオブジェクトに関連付けられている educationOutcome の一部です。 成績とフィードバックを追加または変更できるのは、アプリケーションのアクセス許可を持つ教師またはアプリケーションだけです。 課題がリリースされるまで、学生には成績やフィードバックは表示されません。

reassigned状態の申請を適切に一覧表示するにはヘッダー Prefer: include-unknown-enum-membersを指定します。 詳細については、「例」セクションを参照してください。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) EduAssignments.ReadBasic EduAssignments.Read、EduAssignments.ReadWrite、EduAssignments.ReadWriteBasic
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション EduAssignments.ReadBasic.All EduAssignments.Read.All、EduAssignments.ReadWrite.All、EduAssignments.ReadWriteBasic.All

HTTP 要求

GET /education/classes/{class-id}/assignments/{assignment-id}/submissions/{submission-id}

オプションのクエリ パラメーター

このメソッドは、応答のカスタマイズに役立つ OData クエリ パラメーターの $select$orderby をサポートします。 一般的な情報については、「OData クエリ パラメーター」を参照してください。

educationSubmission リソースの次のプロパティで$orderbyを使用できます。 excusedDateTimereassignedDateTimereturnedDateTimestatussubmitDateTimeunsubmittedDateTime

要求ヘッダー

ヘッダー
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
Prefer include-unknown-enum-members. 省略可能。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは応答コード 200 OK と、応答本文に educationSubmission オブジェクトを返します。

例 1: 省略可能な Prefer ヘッダーのない要求

要求

次の例は要求を示しています。

GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a

応答

次の例は応答を示しています。

筆記: ここで示す応答オブジェクトは、読みやすくするために短縮される場合があります。

この educationSubmission リソースで setUpResourcesFolder がまだ呼び出されていない場合、resourcesFolderUrl プロパティはnull

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 712

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions/$entity",
    "status": "returned",
    "submittedDateTime": null,
    "unsubmittedDateTime": null,
    "returnedDateTime": "2022-04-13T05:11:50.756165Z",
    "reassignedDateTime": null,
    "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%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
    "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a",
    "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": null,
            "displayName": null
        }
    },
    "returnedBy": {
        "application": null,
        "device": null,
        "user": {
            "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
            "displayName": null
        }
    },
    "reassignedBy": {
        "application": null,
        "device": null,
        "user": {
            "id": null,
            "displayName": null
        }
    }
}

例 2: 省略可能な Prefer ヘッダーを含む要求

要求

次の例は要求を示しています。

GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/efbecaf4-6956-4a76-6e10-b901e4de91c5
Prefer: include-unknown-enum-members

応答

次の例は応答を示しています。

筆記: ここで示す応答オブジェクトは、読みやすくするために短縮される場合があります。

この educationSubmission リソースで setUpResourcesFolder がまだ呼び出されていない場合、resourcesFolderUrl プロパティはnull

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 712

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions/$entity",
    "status": "reassigned",
    "submittedDateTime": "2022-04-13T05:10:00.4660243Z",
    "unsubmittedDateTime": null,
    "returnedDateTime": "2022-04-13T05:12:14.6531582Z",
    "reassignedDateTime": "2022-04-13T05:12:14.6531582Z",
    "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%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22efbecaf4-6956-4a76-6e10-b901e4de91c5%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
    "id": "efbecaf4-6956-4a76-6e10-b901e4de91c5",
    "recipient": {
        "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
        "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
    },
    "submittedBy": {
        "application": null,
        "device": null,
        "user": {
            "id": "51cf5a99-d234-4e43-96de-cd65df14bfa1",
            "displayName": null
        }
    },
    "unsubmittedBy": {
        "application": null,
        "device": null,
        "user": {
            "id": null,
            "displayName": null
        }
    },
    "returnedBy": {
        "application": null,
        "device": null,
        "user": {
            "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
            "displayName": null
        }
    },
    "reassignedBy": {
        "application": null,
        "device": null,
        "user": {
            "id": null,
            "displayName": null
        }
    }
}

例 3: $expand オプションを使用して申請を取得する

要求

次の例は要求を示しています。

GET https://graph.microsoft.com/beta/education/classes/a86a5c30-0437-49d6-9c6b-b1ce0d8d5574/assignments/95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f/submissions/e1a0240e-f3af-f039-63e7-09c3cbf8d176?$expand=*

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 4492

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions(outcomes(),resources(),submittedResources())/$entity",
    "status": "returned",
    "submittedDateTime": "2022-10-24T21:03:53.3664034Z",
    "unsubmittedDateTime": null,
    "returnedDateTime": "2022-10-24T21:04:42.7101616Z",
    "reassignedDateTime": null,
    "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%22a86a5c30-0437-49d6-9c6b-b1ce0d8d5574%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%2295da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22e1a0240e-f3af-f039-63e7-09c3cbf8d176%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
    "id": "e1a0240e-f3af-f039-63e7-09c3cbf8d176",
    "recipient": {
        "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
        "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
    },
    "submittedBy": {
        "application": null,
        "device": null,
        "user": {
            "id": "51cf5a99-d234-4e43-96de-cd65df14bfa1",
            "displayName": null
        }
    },
    "unsubmittedBy": {
        "application": null,
        "device": null,
        "user": {
            "id": null,
            "displayName": null
        }
    },
    "returnedBy": {
        "application": null,
        "device": null,
        "user": {
            "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
            "displayName": null
        }
    },
    "reassignedBy": {
        "application": null,
        "device": null,
        "user": {
            "id": null,
            "displayName": null
        }
    },
    "outcomes@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions('e1a0240e-f3af-f039-63e7-09c3cbf8d176')/outcomes",
    "outcomes": [
        {
            "@odata.type": "#microsoft.graph.educationFeedbackOutcome",
            "lastModifiedDateTime": "2022-10-24T21:04:42.3073523Z",
            "id": "ca05367a-b292-42d5-aff7-5d279feeace8",
            "lastModifiedBy": {
                "application": null,
                "device": null,
                "user": {
                    "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
                    "displayName": null
                }
            },
            "feedback": {
                "feedbackDateTime": "2022-10-24T21:04:42.3073523Z",
                "text": {
                    "content": "New feedback!",
                    "contentType": "text"
                },
                "feedbackBy": {
                    "application": null,
                    "device": null,
                    "user": {
                        "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
                        "displayName": null
                    }
                }
            },
            "publishedFeedback": {
                "feedbackDateTime": "2022-10-24T21:04:25.2783852Z",
                "text": {
                    "content": "Feedback",
                    "contentType": "text"
                },
                "feedbackBy": {
                    "application": null,
                    "device": null,
                    "user": {
                        "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
                        "displayName": null
                    }
                }
            }
        },
        {
            "@odata.type": "#microsoft.graph.educationPointsOutcome",
            "lastModifiedDateTime": "2022-10-24T21:04:42.7101541Z",
            "id": "ea1351f6-ba33-4940-b2cb-6a7254af2dc8",
            "lastModifiedBy": {
                "application": null,
                "device": null,
                "user": {
                    "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
                    "displayName": null
                }
            },
            "points": {
                "gradedDateTime": "2022-10-24T21:04:42.7101541Z",
                "points": 456,
                "gradedBy": {
                    "application": null,
                    "device": null,
                    "user": {
                        "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
                        "displayName": null
                    }
                }
            },
            "publishedPoints": {
                "gradedDateTime": "2022-10-24T21:04:25.6308301Z",
                "points": 123,
                "gradedBy": {
                    "application": null,
                    "device": null,
                    "user": {
                        "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
                        "displayName": null
                    }
                }
            }
        },
        {
            "@odata.type": "#microsoft.graph.educationRubricOutcome",
            "lastModifiedDateTime": "2022-10-24T21:04:26.5833776Z",
            "id": "65a46d78-1a2b-4a7e-bcf8-78a22ac2611b",
            "lastModifiedBy": {
                "application": null,
                "device": null,
                "user": {
                    "id": null,
                    "displayName": null
                }
            },
            "rubricQualityFeedback": [
                {
                    "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
                    "feedback": null
                },
                {
                    "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
                    "feedback": {
                        "content": "Needs improvement",
                        "contentType": "text"
                    }
                },
                {
                    "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
                    "feedback": null
                }
            ],
            "rubricQualitySelectedLevels": [
                {
                    "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
                    "columnId": null
                },
                {
                    "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
                    "columnId": "0f9823a2-174c-4ce0-8f12-e298c291f29b"
                },
                {
                    "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
                    "columnId": null
                }
            ],
            "publishedRubricQualityFeedback": [
                {
                    "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
                    "feedback": null
                },
                {
                    "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
                    "feedback": {
                        "content": "Needs improvement",
                        "contentType": "text"
                    }
                },
                {
                    "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
                    "feedback": null
                }
            ],
            "publishedRubricQualitySelectedLevels": [
                {
                    "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
                    "columnId": null
                },
                {
                    "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
                    "columnId": "0f9823a2-174c-4ce0-8f12-e298c291f29b"
                },
                {
                    "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
                    "columnId": null
                }
            ]
        }
    ],
    "resources@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions('e1a0240e-f3af-f039-63e7-09c3cbf8d176')/resources",
    "resources": [],
    "submittedResources@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions('e1a0240e-f3af-f039-63e7-09c3cbf8d176')/submittedResources",
    "submittedResources": []
}