educationAssignment リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
学習の一環としてクラスの学生またはチーム メンバーに割り当てられたタスクあるいは作業ユニットを表します。
課題には、 教師が生徒に取り組んでほしい配布資料とタスクが含まれています。 各学生 の課題 には、教師が入るように求められた作業を含む 関連する提出物 があります。 課題を作成できるのは、教師またはチームの所有者だけです。 教師は、学生が提出した 提出 物にスコアとフィードバックを追加できます。
割り当てが作成されると、下書き状態になります。 学生は 課題を表示できません。 提出物 は作成されません。 発行アクションを使用して、割り当ての状態を変更できます。 PATCH 要求を使用して 割り当ての 状態を変更することはできません。
割り当て API はクラス名前空間で公開されます。
エンティティ から継承します。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| 割り当てリソースの作成 | educationAssignmentResource | リソース コレクションに投稿して、新しい educationAssignmentResource を作成します。 |
| 課題を取得する | educationAssignment | educationAssignment オブジェクトのプロパティとリレーションシップを読み取ります。 |
| Update | educationAssignment | educationAssignment オブジェクトを更新します。 |
| Delete | なし | educationAssignment オブジェクトを削除します。 |
| Publish | educationAssignment | educationAssignment オブジェクトの状態を下書きから発行済みに変更します。 |
| 割り当てリソース フォルダーを設定する | string | SharePoint フォルダー (定義済みの場所の下) を作成して、割り当てリソースとしてファイルをアップロードします。 |
| 割り当てフィードバック リソース フォルダーを設定する | educationAssignment | 特定の educationSubmission のフィードバック ファイルをアップロードする SharePoint フォルダーを作成します。 |
| リソースの一覧表示 | educationAssignmentResource コレクション | educationAssignmentResource オブジェクト コレクションを取得します。 |
| 申請を一覧表示する | educationSubmission コレクション | educationSubmission オブジェクト コレクションを取得します。 |
| カテゴリの一覧表示 | educationCategory コレクション | educationCategory オブジェクト コレクションを取得します。 |
| カテゴリの追加 | educationCategory | クラスに属する educationCategory をこの割り当てに割り当てます。 |
| カテゴリを削除する | なし | クラスに属する educationCategory をこの 割り当てから削除します。 |
| ルーブリックをアタッチする | なし | 既存の educationRubric をこの 割り当てにアタッチします。 |
| ルーブリックを削除する | なし | educationRubric をこの割り当てからデタッチします。 |
| Get delta | educationAssignment コレクション | コレクションの完全な読み取りを実行することなく、新しく作成または更新された 割り当ての 一覧を取得します。 |
| educationGradingCategory の追加 | educationGradingCategory | gradingCategory コレクションに投稿して、gradingCategory を追加します。 |
| educationGradingCategory を削除する | なし | educationGradingCategory オブジェクトを削除します。 |
| 割り当てをアクティブにする | educationAssignment | 非アクティブな educationAssignment をアクティブ化して、課題に教師または学生のための追加のアクション 項目があることを通知します。 |
| 割り当てを非アクティブ化する | educationAssignment | 割り当てられた educationAssignment を 非アクティブとしてマークして、課題に教師と学生の両方に対してそれ以上のアクション 項目がないことを通知します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| addedStudentAction | String | 課題の発行後に追加された学生の 課題 の 動作を制御 するオプション フィールド。 指定しない場合、既定値は に none設定されます。 サポートされる値は、 none、 assignIfOpenです。 たとえば、教師は、課題がまだ開いている間にクラスに参加する新しい学生に課題を割り当てる必要があることを示しnone、課題を新しい学生に割り当ててはならないことを示すために使用assignIfOpenできます。 |
| addToCalendarAction | educationAddToCalendarOptions | 課題の発行時に学生と教師の予定表に課題を追加するための割り当ての動作を制御する省略可能なフィールド。 使用可能な値はnone、、studentsAndPublisher、、unknownFutureValuestudentsAndTeamOwners、および 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 | 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 | 課題の採点方法。 |
| id | String | 割り当ての一意識別子。 エンティティから継承 されます。 読み取り専用。 |
| 指示 | itemBody | 割り当ての手順。 このプロパティと表示名は、学生に何をすべきかを伝えます。 |
| lastModifiedBy | identitySet | 最後に割り当てを変更したユーザー。 |
| lastModifiedDateTime | DateTimeOffset |
割り当てが変更された日時。 学生の提出は課題を変更しません。課題を更新できるのは教師だけです。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| moduleUrl | 文字列 | 割り当てにアクセスするモジュールの URL。 |
| notificationChannelUrl | String |
割り当ての発行通知を投稿するチャネルの 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 コレクション | 設定すると、クラスの平均成績を計算するときに、割り当ての重み付けを異なる方法で行えます。 |
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"},
"lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
"lastModifiedDateTime": "String (timestamp)",
"moduleUrl": "String",
"notificationChannelUrl": "String",
"resourcesFolderUrl": "String",
"status": "String",
"webUrl": "String"
}