名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
学習の一環としてクラスの学生またはチーム メンバーに割り当てられたタスクあるいは作業ユニットを表します。
課題には 、教師が生徒に取り組んでもらいたい配付資料と課題が含まれます。 各生徒 の課題 には、教師から提出を求められた課題 を含む提出物 が関連付けられています。 教師またはチーム所有者のみが 課題を作成できます。 教師は、学生が提出した 提出 物にスコアとフィードバックを追加できます。
課題が作成されると、 課題 は下書き状態になります。 学生は 課題を表示できず、 提出物 も作成されません。 発行アクションを使用して、課題の状態を変更できます。 PATCH 要求を使用して 割り当て の状態を変更することはできません。
割り当て API は、クラス名前空間で公開されます。
エンティティ から継承します。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| Create | educationAssignment | 新しい 課題を作成します。 |
| Get | educationAssignment | educationAssignment オブジェクトのプロパティとリレーションシップを読み取ります。 |
| Update | educationAssignment | educationAssignment オブジェクトを更新します。 |
| Delete | なし | 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 コレクション | コレクションを完全に読み取ることなく、新しく作成または更新された 割り当て の一覧を取得します。 |
| 採点カテゴリの追加 | educationGradingCategory | gradingCategory コレクションに投稿して、gradingCategory を追加します。 |
| 採点カテゴリを削除する | なし | educationGradingCategory オブジェクトを削除します。 |
| 割り当てをアクティブ化する | educationAssignment | 非アクティブな educationAssignment をアクティブ化して、課題に教師または学生のための追加の実施項目があることを通知します。 |
| 割り当てを非アクティブ化する | educationAssignment | 割り当てられた educationAssignment を非アクティブとしてマークして、教師と生徒の両方に対するこれ以上の実施項目がないことを示します。 |
| 採点スキームの追加 | 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 |
割り当てがアクティブになる日付。 今後、 課題 はこの日まで学生に表示されません。
タイムスタンプの種類は、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 | string |
課題の状態。 この値にパッチを適用することはできません。 使用可能な値: draft、scheduled、published、assigned、unknownFutureValue、inactive。
Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型の次のメンバーを取得します。inactive。 |
| webUrl | string | 特定の 課題のディープ リンク URL。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| リソース | educationAssignmentResource コレクション | この 課題に関連付けられている学習オブジェクト。 このリストを変更できるのは教師のみです。 Null 許容型。 |
| 提出 | educationSubmission コレクション | 公開されると、各学生の課題と成績を表す 提出 オブジェクトがあります。 読み取り専用です。 Null 許容型。 |
| categories | educationCategory コレクション | 設定すると、ユーザーは特定の種類の 割り当て を簡単に見つけることができます。 読み取り専用です。 Null 許容型。 |
| ルーブリック | educationRubric | 設定すると、この 課題に添付される採点ルーブリック。 |
| gradingCategory | educationGradingCategory コレクション | 設定すると、クラスの平均成績を計算するときに、課題に異なる重みを付けることができます。 |
| gradingScheme | educationGradingScheme | 設定すると、この 課題で獲得した合計ポイントの割合に基づいて、ユーザーがカスタム文字列成績を構成できます。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"addedStudentAction": "String",
"addToCalendarAction": "String",
"allowLateSubmissions": "Boolean",
"allowStudentsToAddResourcesToSubmission": "Boolean",
"assignDateTime": "String (timestamp)",
"assignedDateTime": "String (timestamp)",
"assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"},
"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"
}