educationAssignment リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。
学習の一環としてクラスの学生またはチーム メンバーに割り当てられたタスクあるいは作業ユニットを表します。
課題 を作成できるのは、教師またはチームの所有者のみです。 課題には、 教師が学生に作業を求める配布資料とタスクが含まれています。 各学生 課題 には、教師が提出するように求められたすべての作業を含む、関連付けられた 提出 物があります。 教師は、学生が提出した 提出 物にスコアとフィードバックを追加できます。
割り当てが 作成されると、下書き状態になります。 学生は 課題 を表示できず、 提出物 は作成されません。 発行アクションを使用して 、割り当ての 状態を変更できます。 PATCH 要求を使用して 割り当て 状態を変更することはできません。
割り当て API は、クラス名前空間で公開されます。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| 割り当てリソースの作成 | educationAssignmentResource | リソース コレクションに投稿して、新しい educationAssignmentResource を作成します。 |
| 課題を取得する | educationAssignment | educationAssignment オブジェクトのプロパティとリレーションシップを読み取ります。 |
| 更新 | educationAssignment | educationAssignment オブジェクトを 更新します。 |
| 削除 | なし | educationAssignment オブジェクトを削除します。 |
| Publish | educationAssignment | educationAssignment オブジェクトの状態を下書きから公開に変更します。 |
| 割り当てリソース フォルダーを設定する | string | SharePoint フォルダー (定義済みの場所) を作成し、ファイルを割り当てリソースとしてアップロードします。 |
| 割り当てのフィードバック リソース フォルダーを設定する | educationAssignment | 特定の educationSubmission のフィードバック ファイルをアップロードする SharePoint フォルダーを作成します。 |
| リソースを一覧表示する | educationAssignmentResource コレクション | educationAssignmentResource オブジェクト コレクションを取得します。 |
| 申請を一覧表示する | educationSubmission コレクション | educationSubmission オブジェクト コレクションを取得します。 |
| カテゴリの一覧表示 | educationCategory コレクション | educationCategory オブジェクト コレクションを取得します。 |
| カテゴリを追加する | educationCategory | クラスに属する educationCategory をこの割り当てに割り当てます。 |
| カテゴリを削除する | なし | この 割り当て から、クラスに属する educationCategory を削除します。 |
| ルーブリックをアタッチする | なし | この 割り当て に既存の educationRubric をアタッチします。 |
| ルーブリックを削除する | なし | educationRubric をこの 割り当て からデタッチします。 |
| 差分を取得する | educationAssignment コレクション | コレクションの完全な読み取りを実行することなく、新しく作成または更新された 割り当ての 一覧を取得します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| id | String | 読み取り専用です。 |
| addedStudentAction | String | 課題の公開後に追加される学生の 課題 の動作を制御するオプション フィールド。 指定しない場合、既定値は value です none 。 現在、2 つの値 none (または assignIfOpen. |
| addToCalendarAction | educationAddToCalendarOptions | 課題が発行されたときに学生と教師の予定表に 割り当てを追加するための割り当ての 動作を制御するオプション フィールド。 指定できる値は、次studentsAndPublisher``studentsAndTeamOwners``unknownFutureValue``studentsOnlyのとおりです。 none この進化可能な列挙型studentsOnlyでPrefer: include-unknown-enum-members次の値を取得するには、要求ヘッダーを使用する必要があることに注意してください。 既定値は 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 | String | この 割り当てが 属するクラス。 |
| 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 | String | 割り当ての 名前。 |
| dueDateTime | DateTimeOffset | 学生の 割り当てが 期限の日付。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| feedbackResourcesFolderUrl | String | この 割り当て のすべてのフィードバック ファイル リソースが格納されるフォルダー URL。 |
| グレーディング | educationAssignmentGradeType | 課題 の採点方法。 |
| 指示 | itemBody | 割り当ての 手順。 これは、表示名と共に、学生に何をすべきかを伝えます。 |
| lastModifiedBy | identitySet | 割り当てを 最後に変更したユーザー。 |
| lastModifiedDateTime | DateTimeOffset | 割り当てが 最後に変更された時点。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| notificationChannelUrl | String | 割り当て 発行通知を投稿する チャネルの URL を指定するオプション フィールド。 指定されていない場合、または null の場合は、既定でチャネルが使用 General されます。 このフィールド **は、**assignTo 値が educationAssignmentClassRecipient である代入にのみ適用されます。 割り当てが 発行された後は 、notificationChannelUrl の更新は許可されません。 |
| status | string | 割り当ての 状態。 この値にパッチを適用することはできません。 使用可能な値: draft、scheduled、published、assigned。 |
| webUrl | string | 特定の 割り当ての ディープ リンク URL。 |
| resourcesFolderUrl | string | この 割り当て のすべてのファイル リソースが格納されるフォルダー URL。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| リソース | educationAssignmentResource コレクション | この 割り当て に関連付けられているラーニング オブジェクト。 このリストを変更できるのは教師だけです。 Null 許容型。 |
| 提出 | educationSubmission コレクション | 公開されると、各学生の仕事と成績を表す 提出 オブジェクトが存在します。 読み取り専用です。 Null 許容型。 |
| categories | educationCategory コレクション | 設定すると、ユーザーは特定の種類 の割り当てを 簡単に見つけることができます。 読み取り専用です。 Null 許容型。 |
| ルーブリック | educationRubric | 設定すると、この 割り当て にアタッチされた採点ルーブリック。 |
JSON 表記
リソースの JSON 表記を次に示します。
{
"id": "String (identifier)",
"addedStudentAction": "none",
"addToCalendarAction": "string",
"allowLateSubmissions": true,
"allowStudentsToAddResourcesToSubmission": true,
"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)",
"grading": {"@odata.type": "microsoft.graph.educationAssignmentGradeType"},
"instructions": {"@odata.type": "microsoft.graph.itemBody"},
"lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
"lastModifiedDateTime": "String (timestamp)",
"notificationChannelUrl": "string",
"status": "string",
"webUrl": "string",
"resourcesFolderUrl": "string"
}
フィードバック
フィードバックの送信と表示