educationAssignment リソースの種類

[アーティクル]
02/26/2024

名前空間: microsoft.graph

学習の一環としてクラスの学生またはチームメンバーに割り当てられたタスクあるいは作業ユニットを表します。

課題には、 教師が生徒に取り組んでほしい配布資料とタスクが含まれています。各学生 の課題 には、教師が入るように求められた作業を含む関連する提出物があります。課題を作成できるのは、教師またはチームの所有者だけです。教師は、学生が提出した提出物にスコアとフィードバックを追加できます。

割り当てが作成されると、下書き状態になります。学生は課題を表示できません。 提出物 は作成されません。発行アクションを使用して、割り当ての状態を変更できます。 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 コレクション	コレクションの完全な読み取りを実行することなく、新しく作成または更新された educationAssignment オブジェクトの一覧を取得します。
educationGradingCategory の追加	educationGradingCategory	educationGradingCategory を educationGradingCategory コレクションに追加します。
educationGradingCategory を削除する	なし	educationGradingCategory コレクションから educationGradingCategory オブジェクトを削除します。
割り当てをアクティブにする	educationAssignment	educationAssignment を`inactive`アクティブ化して、課題に教師または学生向けの追加のアクション項目があることを通知します。
割り当てを非アクティブ化する	educationAssignment	`assigned`educationAssignment`inactive` にマークを付けて、課題に教師と学生のためのそれ以上のアクション項目がないことを示します。

プロパティ

プロパティ	型	説明
addedStudentAction	String	課題の発行後に追加された学生の課題の動作を制御するオプションフィールド。指定しない場合、既定値はに `none`設定されます。サポートされる値は、 `none`、 `assignIfOpen`です。たとえば、教師は、課題がまだ開いている間にクラスに参加する新しい学生に課題を割り当てる必要があることを示し`none`、課題を新しい学生に割り当ててはならないことを示すために使用`assignIfOpen`できます。
addToCalendarAction	educationAddToCalendarOptions	課題の発行時に学生と教師の予定表に課題を追加するための割り当ての動作を制御する省略可能なフィールド。使用可能な値は`none`、、`studentsAndPublisher`、、`unknownFutureValuestudentsAndTeamOwners`、および `studentsOnly`です。要求ヘッダーを使用して、`Prefer: include-unknown-enum-members`この進化可能な列挙型で次の値を取得する必要があります。 `studentsOnly` 既定値は `none` です。
allowLateSubmissions	Boolean	学生が期日以降に提出できるかどうかを識別します。作成中にこのプロパティが指定されていない場合、既定値は 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	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 許容型。
リソース	educationAssignmentResource コレクション	この割り当てに関連付けられている学習オブジェクト。このリストを変更できるのは教師だけです。 Null 許容型。
ルーブリック	educationRubric	設定すると、この課題にアタッチされたグレーディングルーブリックが設定されます。
提出	educationSubmission コレクション	発行されると、各学生が自分の仕事と成績を表す提出オブジェクトが表示されます。読み取り専用です。 Null 許容型。
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"
}