educationAssignment リソースの種類educationAssignment resource type

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでは、これらの API の使用はサポートされていません。Use of these APIs in production applications is not supported.

educationAssignmentリソースは、クラス内の学生またはチームメンバーに割り当てられた作業の1つまたは複数の作業単位を調査の一環として表します。The educationAssignment resource represents a task or unit of work assigned to a student or team member in a class as part of their study. 割り当てを作成できるのは、教師またはチームの所有者のみです。Only teachers or team owners can create assignments. 割り当てには、教師が学生の作業を希望する配布資料とタスクが含まれています。Assignments contain handouts and tasks that the teacher wants the student to work on. 各受講者の割り当てには、教師が有効にすることを求められた仕事がすべて含まれている送信が関連付けられています。Each student assignment has an associated submission that contains any work their teacher asked to be turned in. 教師は、生徒が行った提出物にスコアとフィードバックを追加することができます。A teacher can add scores and feedback to the submission turned in by the student.

割り当てが作成されると、その割り当ては下書き状態になります。When an assignment is created, it is in a Draft state. 学生は、割り当てを表示できません。送信は作成されません。Students can't see the assignment and submissions won't be created. "発行" アクションを使用して、割り当ての状態を変更できます。You can change the status of an assignment by using the publish action. PATCH 要求を使用して割り当ての状態を変更することはできません。You can't use a PATCH request to change the assignment status.

割り当て api は、クラスの名前空間で公開されます。The assignment APIs are exposed in the class namespace.

メソッドMethods

メソッドMethod 戻り値の型Return Type 説明Description
割り当てを取得するGet assignment educationAssignmenteducationAssignment educationAssignmentオブジェクトのプロパティとリレーションシップを読み取ります。Read properties and relationships of an educationAssignment object.
割り当てリソースを作成するCreate assignment resource educationAssignmentResourceeducationAssignmentResource resources コレクションへの投稿によって新しいeducationAssignmentResourceを作成します。Create a new educationAssignmentResource by posting to the resources collection.
リソースを一覧表示するList resources educationAssignmentResourceコレクションeducationAssignmentResource collection educationAssignmentResourceオブジェクトのコレクションを取得します。Get an educationAssignmentResource object collection.
送信の一覧表示List submissions educationSubmissionコレクションeducationSubmission collection educationSubmissionオブジェクトのコレクションを取得します。Get an educationSubmission object collection.
カテゴリの一覧表示List categories educationCategoryコレクションeducationCategory collection educationCategoryオブジェクトのコレクションを取得します。Get an educationCategory object collection.
カテゴリを追加するAdd categories educationCategoryeducationCategory クラスに属するeducationCategoryをこの割り当てに割り当てます。Assign an educationCategory belonging to the class to this assignment.
カテゴリを削除するRemove category なしNone クラスに属するeducationCategoryをこの割り当てから削除します。Remove an educationCategory belonging to the class from this assignment.
更新するUpdate educationAssignmenteducationAssignment educationAssignmentオブジェクトを更新します。Update an educationAssignment object.
削除Delete なしNone educationAssignmentオブジェクトを削除します。Delete an educationAssignment object.
PublishPublish educationAssignmenteducationAssignment educationAssignmentオブジェクトの状態を下書きから発行済みに変更します。Change the state of an educationAssignment object from draft to published.
リソース フォルダーの URL を取得するGet resource folder URL stringstring 割り当てリソースの一部として、ファイルベースのリソースが配置される OneDrive フォルダーです。The OneDrive folder into which file-based resources should be placed to be part of an assignment resource. ファイルをリソースとして追加するには、このフォルダーに配置する必要があります。Files must be located in this folder to be added as a resource.

プロパティProperties

プロパティProperty Type 説明Description
idid StringString 読み取り専用です。Read-only.
allowLateSubmissionsallowLateSubmissions BooleanBoolean 学生が期日を過ぎて送信できるかどうかを指定します。Identifies whether students can submit after the due date. このプロパティが作成時に指定されていない場合、既定値は true になります。If this property is not specified during create, it defaults to true.
allowStudentsToAddResourcesToSubmissionallowStudentsToAddResourcesToSubmission BooleanBoolean 学生が自分のリソースを提出することができるかどうか、または教師が追加したリソースのみを変更できるかどうかを識別します。Identifies whether students can add their own resources to a submission or if they can only modify resources added by the teacher.
割り当ての datetimeassignDateTime DateTimeOffsetDateTimeOffset 割り当てがアクティブになる日付を指定します。The date when the assignment should become active. 今後、この日まで学生に割り当てが表示されることはありません。If in the future, the assignment is not shown to the student until this date. Timestamp型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
への割り当てassignTo educationAssignmentRecipienteducationAssignmentRecipient 割り当てが発行されると、どのユーザーまたはクラス全体が送信オブジェクトを受け取るかを指定します。Which users, or whole class should receive a submission object once the assignment is published.
assignedDateTimeassignedDateTime DateTimeOffsetDateTimeOffset 割り当てが学生に公開され、課題が生徒のタイムラインに表示されます。The moment that the assignment was published to students and the assignment shows up on the students timeline. Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
classIdclassId StringString この割り当てが属するクラス。Class which this assignment belongs.
createdBycreatedBy identitySetidentitySet 割り当てを作成したユーザー。Who created the assignment.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset 割り当てが作成された瞬間。Moment when the assignment was created. Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
displayNamedisplayName StringString 割り当ての名前を指定します。Name of the assignment.
dueDateTimedueDateTime DateTimeOffsetDateTimeOffset 学生の割り当てが期限になる日付。Date when the students assignment is due. Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
変化grading educationAssignmentGradeTypeeducationAssignmentGradeType 割り当てが採点される方法。How the assignment will be graded.
手順instructions itemBodyitemBody 割り当ての手順。Instructions for the assignment. これに加えて、表示名と共に、受講者に実行する操作を指示します。This along with the display name tell the student what to do.
lastModifiedBylastModifiedBy identitySetidentitySet 割り当てを最後に変更したユーザー。Who last modified the assignment.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset 割り当てが最後に変更された瞬間。Moment when the assignment was last modified. Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
statusstatus stringstring 割り当ての状態。Status of the Assignment. この値を修正することはできません。You can not PATCH this value. 可能な値は、draftpublishedassigned です。Possible values are: draft, published, assigned.

リレーションシップRelationships

リレーションシップRelationship Type 説明Description
リソースresources educationAssignmentResourceコレクションeducationAssignmentResource collection この割り当てに関連付けられているオブジェクトを学習します。Learning objects that are associated with this assignment. このリストは教師のみが変更できます。Only teachers can modify this list. Null 許容型。Nullable.
投稿submissions educationSubmissionコレクションeducationSubmission collection 発行された後に、各学生の仕事と成績を表す送信オブジェクトがあります。Once published, there is a submission object for each student representing their work and grade. 読み取り専用です。Read-only. Null 許容型。Nullable.
categoriescategories educationCategoryコレクションeducationCategory collection 設定されている場合、ユーザーは特定の種類の割り当てを簡単に見つけることができます。When set, enables users to easily find assignments of a given type. 読み取り専用です。Read-only. Null 許容型。Nullable.

JSON 表記JSON representation

リソースの JSON 表記を次に示します。The following is a JSON representation of the resource.

{
  "id": "String (identifier)",
  "allowLateSubmissions": true,
  "allowStudentsToAddResourcesToSubmission": true,
  "assignDateTime": "String (timestamp)",
  "assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"},
  "assignedDateTime": "String (timestamp)",
  "classId": "String",
  "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)",
  "status": "string"
}