REST Resource: courses.courseWork.studentSubmissions

リソース: StudentSubmission

コースワークの生徒の提出物。

StudentSubmission アイテムは、CourseWork アイテムの作成時に生成されます。

一度もアクセスされていない生徒の提出物（state = NEW）には、作成日時や更新日時がない場合があります。

JSON 表現 
{
  "courseId": string,
  "courseWorkId": string,
  "id": string,
  "userId": string,
  "creationTime": string,
  "updateTime": string,
  "state": enum (SubmissionState),
  "late": boolean,
  "draftGrade": number,
  "assignedGrade": number,
  "rubricId": string,
  "draftRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "assignedRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
}
フィールド
courseId

string

コースの識別子。

読み取り専用です。
courseWorkId

string

対応するコース課題の識別子。

読み取り専用です。
id

string

生徒の提出物に Classroom で割り当てられた識別子。これは、関連するコースワークの提出物の中で一意です。

読み取り専用です。
userId

string

この提出物を所有する生徒の識別子。

読み取り専用です。
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"。
state

enum (SubmissionState)

この提出物のステータス。

読み取り専用です。
late

boolean

この提出が遅れているかどうか。

読み取り専用です。
draftGrade

number

保留中の成績（省略可）。未設定の場合、成績は設定されていません。この値は 0 または正の数値にしてください。小数（整数以外）の値も使用できますが、小数点以下 2 桁に丸められます。

この設定は、コースの教師のみが表示、変更できます。
assignedGrade

number

成績は任意です。未設定の場合、成績は設定されていません。この値は 0 または正の数値にしてください。小数（整数以外）の値も使用できますが、小数点以下 2 桁に丸められます。

これを変更できるのはコースの教師のみです。
rubricId

string

出力専用。このコースの課題に現在添付されており、この生徒の提出物の採点に使用されているルーブリックの識別子。

ルーブリックがない場合、この ID は空です。この ID は現在有効なルーブリックを反映します。教師がルーブリックを削除して再作成すると、この ID は変更されます。

読み取り専用。
draftRubricGrades

map (key: string, value: object (RubricGrade))

ルーブリックの基準に基づく保留中のルーブリックの成績。

このコースワークにルーブリックが添付されていない場合、またはルーブリックが添付されているが、どの評価基準にも成績が設定されていない場合、このマップは空になります。設定されている成績のみが入力されます。キー: ルーブリックの条件 ID。

読み取り専用です。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }
assignedRubricGrades

map (key: string, value: object (RubricGrade))

ルーブリックの基準に基づいて割り当てられたルーブリックの成績。

このコースワークにルーブリックが添付されていない場合、またはルーブリックが添付されているが、どの基準にも成績が設定されていない場合、このマップは空になります。設定されている成績のみが入力されます。キー: ルーブリックの条件 ID。

読み取り専用です。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }
courseWorkType

enum (CourseWorkType)

この提出物の対象となるコースの課題の種類。

読み取り専用です。
associatedWithDeveloper

boolean

この生徒の提出物が、リクエストを行っている Developer Console プロジェクトに関連付けられているかどうか。

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

読み取り専用です。
submissionHistory[]

object (SubmissionHistory)

提出物の履歴（ステータスと成績の履歴を含む）。

読み取り専用です。
previewVersion

enum (PreviewVersion)

出力専用。API のプレビュー版。プレビュー プログラムでデベロッパーに提供される新しい API 機能にアクセスするには、これを設定する必要があります。
送信内容。具体的なタイプは course_work_type の値によって異なります。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
assignmentSubmission

object (AssignmentSubmission)

courseWorkType が ASSIGNMENT の場合の提出物の内容。

生徒は studentSubmissions.modifyAttachments を使用してこのコンテンツを変更できます。
shortAnswerSubmission

object (ShortAnswerSubmission)

courseWorkType が SHORT_ANSWER_QUESTION の場合の提出物の内容。
multipleChoiceSubmission

object (MultipleChoiceSubmission)

courseWorkType が MULTIPLE_CHOICE_QUESTION の場合の提出物の内容。
相互に排他的なフィールドの終了。

RubricGrade

生徒の提出物に設定されたルーブリックの成績。ルーブリックの基準ごとに最大 1 つのエントリがあります。

JSON 表現 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
フィールド
criterionId

string

省略可。条件 ID。
levelId

string

省略可。選択したレベルのオプションのレベル ID。空の場合、レベルは選択されていません。
points

number

省略可。この評価基準に割り当てられたオプションのポイント。通常はレベルに基づきます。レベルにはポイントがある場合とない場合があります。未設定の場合、この条件にポイントは設定されていません。

AssignmentSubmission

課題に対する生徒の提出物。

JSON 表現 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
フィールド
attachments[]

object (Attachment)

生徒が追加した添付ファイル。共有モードが STUDENT_COPY の教材に対応するドライブ ファイルは、生徒が Classroom で課題にアクセスしていない場合、まだ存在しない可能性があります。

一部のアタッチメント メタデータは、リクエスト元のユーザーにアクセス権がある場合にのみ入力されます。identifier フィールドと alternateLink フィールドは常に使用できますが、他のフィールド（title など）は使用できない場合があります。

添付ファイル

生徒の出題された課題に添付ファイルが追加されました。

添付ファイルを作成するときに、form フィールドを設定することはできません。

JSON 表現 
{

  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
}
フィールド
添付ファイル データ。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
driveFile

object (DriveFile)

Google ドライブの添付ファイル。
youTubeVideo

object (YouTubeVideo)

YouTube 動画の添付ファイル。
form

object (Form)

Google フォームの添付ファイル。
相互に排他的なフィールドの終了。

ShortAnswerSubmission

記述式問題に対する生徒の提出物。

JSON 表現 
{
  "answer": string
}
フィールド
answer

string

記述式の質問に対する生徒の回答。

MultipleChoiceSubmission

多肢選択式の質問に対する生徒の回答。

JSON 表現 
{
  "answer": string
}
フィールド
answer

string

生徒が選択した選択肢。

SubmissionHistory

送信の履歴。これには現在、状態とグレードの履歴が含まれます。

JSON 表現 
{

  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
}
フィールド
SubmissionHistory のタイプ。StateHistory、GradeHistory のいずれかになります。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
stateHistory

object (StateHistory)

送信の状態履歴情報（存在する場合）。
gradeHistory

object (GradeHistory)

提出物の成績履歴情報（存在する場合）。
相互に排他的なフィールドの終了。

StateHistory

この送信がこれまでに経てきた各状態の履歴。

JSON 表現 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
フィールド
state

enum (State)

ワークフロー パイプラインのステージ。
stateTimestamp

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"。
actorUserId

string

変更を行った教師または生徒。

州

提出物が取り得る状態。

列挙型
STATE_UNSPECIFIED 状態が指定されていません。この値が返されることはありません。
CREATED 提出物が作成されました。
TURNED_IN 生徒が割り当てられたドキュメントを提出した。このドキュメントはテンプレートである場合とそうでない場合がある。
RETURNED 教師が割り当てられたドキュメントを生徒に返却した。
RECLAIMED_BY_STUDENT 生徒が割り当てられたドキュメントを提出した後、課題の [提出を取り消し] を選択したため、生徒がオーナーとして再び管理権限を持つようになった。
STUDENT_EDITED_AFTER_TURN_IN 生徒が提出後に課題を編集しました。現在、生徒が解答を編集する際に、質問でのみ使用されます。

GradeHistory

この提出物の各成績の履歴。

JSON 表現 
{
  "pointsEarned": number,
  "maxPoints": number,
  "gradeTimestamp": string,
  "actorUserId": string,
  "gradeChangeType": enum (GradeChangeType)
}
フィールド
pointsEarned

number

提出物の成績履歴における、この時点の成績の分子。
maxPoints

number

提出物の成績履歴における、この時点での成績の分母。
gradeTimestamp

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"。
actorUserId

string

成績を変更した教師。
gradeChangeType

enum (GradeChangeType)

提出物の成績履歴における、この時点での成績変更のタイプ。

GradeChangeType

成績変更のタイプ。

列挙型
UNKNOWN_GRADE_CHANGE_TYPE 成績変更タイプが指定されていません。この値が返されることはありません。
DRAFT_GRADE_POINTS_EARNED_CHANGE 下書きの成績の分子の変更。
ASSIGNED_GRADE_POINTS_EARNED_CHANGE 割り当てられた成績の分子の変更。
MAX_POINTS_CHANGE 成績の分母の変更。

メソッド

get

 生徒の提出物を返します。

list

 リクエストの OAuth スコープを考慮して、リクエスト元に表示が許可されている生徒の提出物のリストを返します。

modifyAttachments

 生徒の提出物の添付ファイルを変更します。

patch

 生徒の提出物の 1 つ以上のフィールドを更新します。

reclaim

 オーナーである生徒に代わって、生徒の提出物を再要求します。

return

 生徒の提出物を返します。

turnIn

 生徒の提出物を提出します。