Microsoft Graph での割り当ての状態、遷移、制限事項
課題は、教師と学生の行動の相互作用の重要な部分です。 この記事では、プロセス フロー中の割り当て状態の変更と、Microsoft Graph のどの教育 API が関係するかを説明します。
割り当ての状態と遷移
課題は、学習の一環としてクラスの学生またはチーム メンバーに割り当てられたタスクまたは作業単位を表します。 課題を作成、コピー、またはスケジュールできるのは、教師またはチームの所有者だけです。 これらのアクションは、割り当ての状態に影響します。 次の表に、割り当ての状態と、状態の変更に使用できる API の一覧を示します。
| 状態 | 説明 | REST API 呼び出し | 編集できる機能 |
|---|---|---|---|
| 下書き | 新しい割り当てが作成されたとき、または既存の割り当てからコピーされたときの初期状態。 | POST /education/classes/{id}/assignments |
リソース、カテゴリ、ルーブリック |
| Published | 課題が割り当てられた各学生に配布されたときのバックグラウンド処理状態。 | POST /education/classes/{id}/assignments/{id}/publish |
|
| スケジュール済み | 教師が将来発行するように割り当てをスケジュールしたときの状態。 | PATCH /education/classes/{id}/assignments/{id}POST /education/classes/{id}/assignments/{id}/publish |
リソース、カテゴリ、ルーブリック |
| 割り当て済み | 発行プロセスが完了すると、割り当てが割り当てられた状態に移動され、学生が使用できるようになるか、アクティブな状態のままになります。 | POST /education/classes/{id}/assignments/{id}/publishPOST /education/classes/{id}/assignments/{id}/activate |
提出物 |
| Pending | 新しい割り当てが既存の割り当てからコピーされている場合のバックグラウンド処理の状態。 | PATCH /education/classes/{id}/assignments/{id} |
|
| 非アクティブ | 課題には、教師と学生のための追加のアクション 項目はありません。 | POST /education/classes/{id}/assignments/{id}/deactivate |
次の図は、割り当てで発生する可能性がある状態遷移を示しています。
割り当てが発行されていることを確認する方法
呼び出し元は、GET 割り当て操作を使用して現在の割り当て状態をチェックし、発行プロセスが成功したことを確認する必要があります。
許可されたアクションに基づく割り当て状態の遷移
| 現在の割り当て状態 | 新しいアクション | 新しい状態 |
|---|---|---|
| 下書き | 教師が課題をスケジュールする | スケジュール済み |
| 下書き | 公開 | Published |
| 下書き | 編集 | 下書き |
| 下書き | 破棄 | |
| Published | 発行が完了しました | 割り当て済み |
| Published | 発行に失敗しました | 下書き |
| Published | 破棄 | |
| スケジュール済み | 期限に達する | Published |
| スケジュール済み | スケジュールの取り消し | 下書き |
| スケジュール済み | スケジュール | スケジュール済み |
| 割り当て済み | 破棄 | |
| 割り当て済み | Deactivated | 非アクティブ |
| Pending | コピーが完了しました | 下書き |
| Pending | 破棄 | |
| 非アクティブ | Activated | 割り当て済み |
注:
テーブルに一覧表示されているアクションと状態遷移のみが許可されます。
割り当て API 呼び出しに対する非同期操作と同期
次の表に、割り当ての状態と操作の種類に影響する API 呼び出しを示します。
同期操作は一度に 1 つずつ実行されます。 次の操作を開始する前に各操作を完了する必要があり、最終的な結果は、すべての操作が完了した後にのみ返されます。 非同期操作を使用すると、複数のタスクを同時に実行できます。 1 つの操作が進行中の間、前の操作が完了する前に別の操作を開始できます。 非同期操作には通常、バックグラウンド アクティビティが含まれます。呼び出し元は、ポーリングまたは監視によって結果が使用可能になるまでアクティブにチェックする必要があります。
| API | 同期または非同期 | 最新の状態を取得するメカニズム |
|---|---|---|
DELETE /education/classes/{id}/assignments/{id} |
Async | 投票 |
POST /education/classes/{id}/assignments/{id}/publish |
Async | 投票 |
PATCH /education/classes/{id}/assignments/{id} |
Async | 投票 |
POST /education/classes/{id}/assignments |
Async | 投票 |
POST /education/classes/{id}/assignments/{id}/deactivate |
Async | 投票 |
POST /education/classes/{id}/assignments/{id}/activate |
Async | 投票 |
制限
すべての API 呼び出しには、次の制限が適用されます。
- 割り当てリソースの最大数は、教師に対して 10 です。
- リソースに許可される最大サイズは 500 MB です。
- 調整の制限が適用されます。詳細については、「 Microsoft Graph の調整ガイダンス」を参照してください。