REST Resource: courses.courseWork

リソース: CourseWork

教師がコースの生徒のために作成したコースワーク。

JSON 表現 
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },
  "previewVersion": enum (PreviewVersion),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "gradingPeriodId": string
}
フィールド
courseId

string

コースの識別子。

読み取り専用です。
id

string

Classroom によって割り当てられた、このコース課題の識別子。コースごとに一意です。

読み取り専用です。
title

string

このコースの課題のタイトル。タイトルは、1 ～ 3,000 文字の有効な UTF-8 文字列にする必要があります。
description

string

このコースワークの説明（省略可）。設定する場合、説明は 30,000 文字以内の有効な UTF-8 文字列にする必要があります。
materials[]

object (Material)

その他の教材

CourseWork には 20 個以下の教材アイテムが必要です。
state

enum (CourseWorkState)

このコースの課題のステータス。指定しない場合、デフォルトの状態は DRAFT です。
creationTime

string (Timestamp format)

このコースの課題が作成されたときのタイムスタンプ。

読み取り専用です。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

このコースの課題の最新の変更のタイムスタンプ。

読み取り専用です。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
dueDate

object (Date)

このコースの課題の提出期限（UTC）。省略可。dueTime が指定されている場合は、これを指定する必要があります。
dueTime

object (TimeOfDay)

このコースの課題の提出期限（UTC）。dueDate が指定されている場合は、これを指定する必要があります。
scheduledTime

string (Timestamp format)

このコースの課題を公開する予定のタイムスタンプ（省略可）。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
maxPoints

number

このコースの課題の最高成績。0 または未指定の場合、この課題は採点対象外と見なされます。この値は、負の値でない整数にする必要があります。
workType

enum (CourseWorkType)

このコースの課題のタイプ。

タイプは、コースワークの作成時に設定され、変更できません。
associatedWithDeveloper

boolean

このコースワーク アイテムが、リクエストを行う Developer Console プロジェクトに関連付けられているかどうか。

詳しくは、courseWork.create をご覧ください。

読み取り専用です。
assigneeMode

enum (AssigneeMode)

コースワークの割り当てモード。指定しない場合、デフォルト値は ALL_STUDENTS です。
individualStudentsOptions

object (IndividualStudentsOptions)

コースワークにアクセスできる生徒の ID。このフィールドは、assigneeMode が INDIVIDUAL_STUDENTS の場合にのみ設定されます。assigneeMode が INDIVIDUAL_STUDENTS の場合、このフィールドで指定された生徒にのみコースワークが割り当てられます。
submissionModificationMode

enum (SubmissionModificationMode)

生徒が提出物を変更できるタイミングを決定する設定。指定しない場合、デフォルト値は MODIFIABLE_UNTIL_TURNED_IN です。
creatorUserId

string

学習コースを作成したユーザーの ID。

読み取り専用です。
topicId

string

このコースワークが関連付けられているトピックの識別子。コース内の既存のトピックと一致する必要があります。
gradeCategory

object (GradeCategory)

このコースワークの成績が寄与するカテゴリ。コースワークにカテゴリが選択されている場合にのみ表示されます。総合成績の計算に使用される場合があります。

読み取り専用です。
previewVersion

enum (PreviewVersion)

出力専用。このリソースの取得に使用された API のプレビュー版。
learningGoals[]

object (LearningGoal)

省略可。

この授業に関連付けられている学習目標への参照。CourseWork に設定できる学習目標は最大 10 個です。このフィールドは、適切な previewVersion が設定されている場合にのみ入力されます。
コースワークのタイプに固有の追加の詳細。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
assignment

object (Assignment)

課題の詳細。これは、workType が ASSIGNMENT の場合にのみ入力されます。

読み取り専用です。
multipleChoiceQuestion

object (MultipleChoiceQuestion)

多肢選択式の質問の詳細。読み取りオペレーションの場合、このフィールドは workType が MULTIPLE_CHOICE_QUESTION の場合にのみ入力されます。書き込みオペレーションの場合、workType が MULTIPLE_CHOICE_QUESTION の課題を作成するときにこのフィールドを指定する必要があります。それ以外の場合は設定しないでください。
相互に排他的なフィールドの終了。
gradingPeriodId

string

学習コースに関連付けられた採点期間の ID。

  • 作成時に指定されていない場合、採点期間 ID は dueDate（dueDate が設定されていない場合は scheduledTime）に基づいて設定されます。
  • 採点期間との関連付けがないことを示すには、このフィールドを空の文字列（""）に設定します。
  • 指定する場合は、コース内の既存の採点期間 ID と一致する必要があります。

CourseWorkState

コースワークの取り得る状態。

列挙型
COURSE_WORK_STATE_UNSPECIFIED 状態が指定されていません。これは返されません。
PUBLISHED 公開された作業のステータス。これがデフォルトの状態です。
DRAFT まだ公開されていない作品のステータス。この状態の課題は、コースの教師とドメイン管理者のみが閲覧できます。
DELETED 公開されたが、現在は削除されている作品のステータス。この状態の課題は、コースの教師とドメイン管理者のみが閲覧できます。この状態の作業は、しばらくすると削除されます。

SubmissionModificationMode

生徒の提出物の変更モード。

列挙型
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED 変更モードが指定されていません。これは返されません。
MODIFIABLE_UNTIL_TURNED_IN 提出物は、提出する前に変更できます。
MODIFIABLE 提出物はいつでも変更できます。

割り当て

割り当てに関する追加の詳細。

JSON 表現 
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
フィールド
studentWorkFolder

object (DriveFolder)

生徒の提出物の添付ファイルが保存されるドライブ フォルダ。このフィールドは、コースの教師と管理者のみに表示されます。

MultipleChoiceQuestion

多肢選択式の質問に関する追加の詳細。

JSON 表現 
{
  "choices": [
    string
  ]
}
フィールド
choices[]

string

選択肢。

メソッド

create

 コースの課題を作成します。

delete

 コースワークを削除します。

get

 コースの課題を返します。

getAddOnContext

 特定の投稿のコンテキストで Classroom アドオンのメタデータを取得します。

list

 リクエスト元が表示を許可されているコースワークのリストを返します。

modifyAssignees

 課題の割り当てモードとオプションを変更します。

patch

 1 つ以上のコースワークのフィールドを更新します。