名前空間: microsoft.graph
学習の一環としてクラスの学生またはチーム メンバーに割り当てられたタスクあるいは作業ユニットを表します。
課題には、 教師が生徒に取り組んでほしい配布資料とタスクが含まれています。 各学生 の課題 には、教師が入るように求められた作業を含む 関連する提出物 があります。 課題を作成できるのは、教師またはチームの所有者だけです。 教師は、学生が提出した 提出 物にスコアとフィードバックを追加できます。
割り当てが作成されると、下書き状態になります。 学生は 課題を表示できません。 提出物 は作成されません。 発行アクションを使用して、割り当ての状態を変更できます。 PATCH 要求を使用して 割り当ての 状態を変更することはできません。
割り当て API はクラス名前空間で公開されます。
エンティティ から継承します。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| Create | educationAssignment | 新しい 割り当てを作成します。 |
| Get | educationAssignment | educationAssignment オブジェクトのプロパティとリレーションシップを読み取ります。 |
| Update | educationAssignment | educationAssignment オブジェクトを更新します。 |
| 削除 | なし | educationAssignment オブジェクトを削除します。 |
| Publish | educationAssignment | educationAssignment オブジェクトの状態を下書きから発行済みに変更します。 |
| 割り当てリソースの作成 | educationAssignmentResource | 割り当てリソースを作成します。 |
| 割り当てリソースを取得する | educationAssignmentResource | 課題に関連付けられている 教育割り当てリソース のプロパティを取得 します。 |
| 割り当てリソースを削除する | なし | 割り当てにアタッチされている特定の教育割り当てリソースを削除します。 |
| 割り当てリソース フォルダーを設定する | string | SharePoint フォルダー (定義済みの場所の下) を作成して、割り当てリソースとしてファイルをアップロードします。 |
| 割り当てフィードバック リソース フォルダーを設定する | educationAssignment | 特定の educationSubmission のフィードバック ファイルをアップロードする SharePoint フォルダーを作成します。 |
| リソースを一覧表示する | educationAssignmentResource コレクション | educationAssignmentResource オブジェクト コレクションを取得します。 |
| 申請を一覧表示する | educationSubmission コレクション | educationSubmission オブジェクト コレクションを取得します。 |
| カテゴリの一覧表示 | educationCategory コレクション | educationCategory オブジェクト コレクションを取得します。 |
| カテゴリを追加する | educationCategory | クラスに属する educationCategory をこの割り当てに割り当てます。 |
| カテゴリを削除する | なし | クラスに属する educationCategory をこの割り当てから削除します。 |
| ルーブリックを添付する | なし | 既存の educationRubric をこの割り当てにアタッチします。 |
| ルーブリックを削除する | なし | educationRubric をこの割り当てからデタッチします。 |
| Get delta | educationAssignment コレクション | コレクションの完全な読み取りを実行することなく、新しく作成または更新された educationAssignment オブジェクトの一覧を取得します。 |
| グレーディング カテゴリを追加する | educationGradingCategory | educationAssignment に gradingCategoryを追加します。 |
| グレーディング カテゴリを削除する | なし | educationAssignment から gradingCategory を削除します。 |
| 割り当てをアクティブ化する | educationAssignment |
inactive
educationAssignment をアクティブ化して、課題に教師または学生向けのさらにアクション 項目があることを通知します。 |
| 割り当てを非アクティブ化する | educationAssignment |
assigned
educationAssignment をinactiveとしてマークして、課題に教師と学生のためのそれ以上のアクション 項目がないことを通知します。 |
| グレーディング スキームを追加する | educationGradingScheme | 既存の educationGradingScheme を既存の educationAssignment に追加します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| addedStudentAction | 文字列 | 課題の発行後に追加された学生の 課題 の 動作を制御 するオプション フィールド。 指定しない場合、既定値は none。 サポートされる値は、 none、 assignIfOpenです。 たとえば、教師は assignIfOpen を使用して、課題がまだ開いている間にクラスに参加する新しい学生に課題を割り当てる必要があることを示し、課題を新しい学生に割り当ててはならないことを示 none 。 |
| addToCalendarAction | educationAddToCalendarOptions | 課題の発行時に学生と教師の予定表に課題を追加するための割り当ての動作を制御する省略可能なフィールド。 使用可能な値は、 none、 studentsAndPublisher、 studentsAndTeamOwners、 unknownFutureValue、および studentsOnlyです。
Prefer: include-unknown-enum-members要求ヘッダーを使用して、この進化可能な列挙型の次の値を取得します:studentsOnly。 既定値は none です。 |
| allowLateSubmissions | ブール型 | 学生が期日以降に提出できるかどうかを識別します。 作成中にこのプロパティが指定されていない場合、既定値は true になります。 |
| allowStudentsToAddResourcesToSubmission | ブール型 | 学生が自分のリソースを 提出 に追加できるかどうか、または教師によって追加されたリソースのみを変更できるかどうかを識別します。 |
| assignDateTime | DateTimeOffset |
割り当てがアクティブになる日付。 将来の場合、この日付まで 課題 は学生に表示されません。
Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時刻です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| assignTo | educationAssignmentRecipient | 割り当てが発行されると、どのユーザーまたはクラス全体が申請オブジェクトを受け取る必要があります。 |
| assignedDateTime | DateTimeOffset | 課題が学生に発行され、課題が学生タイムラインに表示される瞬間。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| classId | 文字列 | この 割り当てが 属するクラス。 |
| closeDateTime | DateTimeOffset |
申請の割り当てが終了した日付。 これは省略可能なフィールドで、 割り当てが AllowLateSubmissions を許可しない場合、または closeDateTime が dueDateTime と同じ場合に null になる可能性があります。 ただし、指定した場合、closeDateTime は dueDateTime 以上である必要があります。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| createdBy | identitySet | 割り当てを作成したユーザー。 |
| createdDateTime | DateTimeOffset |
割り当てが作成された瞬間。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| displayName | 文字列 | 割り当ての名前。 |
| dueDateTime | DateTimeOffset | 学生の 課題 の期限が設定された日付。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| feedbackResourcesFolderUrl | 文字列 | この 割り当て のすべてのフィードバック ファイル リソースが格納されているフォルダー URL。 |
| 採点 | educationAssignmentGradeType | 課題の採点方法。 |
| id | 文字列 | 割り当ての一意識別子。 エンティティから継承 されます。 読み取り専用です。 |
| 指示 | itemBody | 割り当ての手順。 指示と表示名は、学生に何をすべきかを伝えます。 |
| languageTag | 文字列 | 割り当ての UI 通知を表示する言語を指定します。
languageTag が指定されていない場合、既定の言語はen-US。 省略可能。 |
| lastModifiedBy | identitySet | 最後に割り当てを変更したユーザー。 |
| lastModifiedDateTime | DateTimeOffset |
割り当てが変更された日時。 学生の提出は課題を変更しません。課題を更新できるのは教師だけです。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| moduleUrl | string | 割り当てにアクセスするモジュールの URL。 |
| notificationChannelUrl | 文字列 |
割り当ての発行通知を投稿するチャネルの URL を指定する省略可能なフィールド。 指定しない場合、または null の場合、既定値は General チャネルになります。 このフィールドは、assignTo 値が educationAssignmentClassRecipient である割り当てにのみ適用されます。 割り当てが発行された後、 notificationChannelUrl の更新は許可されません。 |
| resourcesFolderUrl | string | この 割り当て のすべてのファイル リソースが格納されるフォルダー URL。 |
| status | educationAssignmentStatus |
割り当ての状態。 この値に修正プログラムを適用することはできません。 使用可能な値: draft、scheduled、published、assigned、unknownFutureValue、inactive。
Prefer: include-unknown-enum-members要求ヘッダーを使用して、この進化可能な列挙型の次のメンバーを取得します:inactive。 |
| webUrl | string | 指定された 割り当てのディープ リンク URL。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| categories | educationCategory コレクション | 設定すると、ユーザーは特定の型 の割り当てを 簡単に見つけることができます。 読み取り専用です。 Null 許容型。 |
| gradingCategory | educationGradingCategory コレクション | 設定すると、クラスの平均成績を計算するときに、割り当ての重み付けを異なる方法で行えます。 |
| gradingScheme | educationGradingScheme | 設定すると、ユーザーは、この 割り当てで獲得した合計ポイントの割合に基づいてカスタム文字列の成績を構成できます。 |
| リソース | educationAssignmentResource コレクション | この割り当てに関連付けられている学習オブジェクト。 このリストを変更できるのは教師だけです。 Null 許容型。 |
| ルーブリック | educationRubric | 設定すると、この課題にアタッチされたグレーディング ルーブリックが 設定されます。 |
| 提出 | educationSubmission コレクション | 発行されると、各学生が自分の仕事と成績を表す 提出 オブジェクトが表示されます。 読み取り専用です。 Null 許容型。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"addedStudentAction": "String",
"addToCalendarAction": "String",
"allowLateSubmissions": "Boolean",
"allowStudentsToAddResourcesToSubmission": "Boolean",
"assignDateTime": "String (timestamp)",
"assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"},
"assignedDateTime": "String (timestamp)",
"classId": "String",
"closeDateTime": "String (timestamp)",
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "String (timestamp)",
"displayName": "String",
"dueDateTime": "String (timestamp)",
"feedbackResourcesFolderUrl": "String",
"grading": {"@odata.type": "microsoft.graph.educationAssignmentGradeType"},
"id": "String (identifier)",
"instructions": {"@odata.type": "microsoft.graph.itemBody"},
"languageTag": "String",
"lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
"lastModifiedDateTime": "String (timestamp)",
"moduleUrl": "String",
"notificationChannelUrl": "String",
"resourcesFolderUrl": "String",
"status": "String",
"webUrl": "String"
}