名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
特定の educationAssignment のファイルをアップロードする SharePoint フォルダーを作成します。 この操作を実行できるのは教師だけです。
教師は、課題のフォルダーにアップロードするリソースを決定します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | EduAssignments.ReadWrite | 注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | EduAssignments.ReadWrite.All | 注意事項なし。 |
HTTP 要求
POST /education/classes/{id}/assignments/{id}/setUpResourcesFolder
要求ヘッダー
| ヘッダー | 値 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
| Content-Type | application/json. 必須です。 |
要求本文
要求本文で、このメソッドの {} 空の JSON オブジェクトを指定します。
応答
成功した場合、このメソッドは要求本文に 200 OK 応答コードと educationAssignment オブジェクトを返します。
指定した 割り当て に既にフォルダーがある場合、このメソッドは 400 Bad request とエラー応答を返します。
例
次の例は、この API を呼び出す方法を示しています。
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/beta/education/classes/ce2cd7da-e41b-4e66-8390-c9251e4c3a40/assignments/f5e60dc1-d084-4ca4-a3b4-025f11023059/setUpResourcesFolder
Content-type: application/json
{
}
応答
次の例は応答を示しています。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.educationAssignment",
"classId": "ce2cd7da-e41b-4e66-8390-c9251e4c3a40",
"displayName": "New assignment",
"closeDateTime": null,
"dueDateTime": "2025-05-09T00:00:00Z",
"assignDateTime": null,
"assignedDateTime": null,
"allowLateSubmissions": true,
"resourcesFolderUrl": "https://graph.microsoft.com/beta/drives/b!uf0jSRLkbEOG04PymQ5PtqVEDwHjP_xMlkkpCG-1CkKVvLn9JeueT63KQGyKclfr/items/01VPGD5VK63GWH3UQMJVFKZHZUA545JCBB",
"feedbackResourcesFolderUrl": null,
"createdDateTime": "2025-05-07T18:17:06.2831309Z",
"lastModifiedDateTime": "2025-05-16T18:21:18.9640425Z",
"allowStudentsToAddResourcesToSubmission": false,
"status": "draft",
"notificationChannelUrl": 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%22ce2cd7da-e41b-4e66-8390-c9251e4c3a40%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%22f5e60dc1-d084-4ca4-a3b4-025f11023059%5C%22%5D%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22assignment-viewer%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D",
"addToCalendarAction": "none",
"addedStudentAction": "none",
"languageTag": "es",
"moduleUrl": null,
"id": "f5e60dc1-d084-4ca4-a3b4-025f11023059",
"grading": null,
"instructions": {
"content": null,
"contentType": "text"
},
"assignTo": {
"@odata.type": "#microsoft.graph.educationAssignmentClassRecipient"
},
"createdBy": {
"application": null,
"device": null,
"user": {
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null
}
},
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "00000003-0000-0000-c000-000000000000",
"displayName": null
}
}
}
指定した 割り当て に既にフォルダーがある場合、このメソッドは 400 Bad request とエラー応答を返します。
HTTP/1.1 400 Bad request
Content-type: application/json
{
"error": {
"code": "badRequest",
"message": "Bad request.",
"innerError": {
"code": "folderAlreadyExists",
"message": "Resource folder already exists and has previously been set up.",
"date": "2021-09-14T19:05:24",
"request-id": "f88be238-1339-49c8-b03d-37f45d54761f",
"client-request-id": "30d8081a-f3e8-73e0-2da4-3480fb56ccdb"
}
}
}