REST Resource: courses.courseWork.studentSubmissions

リソース: StudentSubmission

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

CourseWork アイテムを作成すると、StudentSubmission 個のアイテムが生成されます。

生徒の提出物に一度もアクセスしたことがない（例: state = 新規）場合、作成日時や更新日時を指定することはできません。

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),

  // Union field content can be only one of the following:
  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
  // End of list of possible types for union field content.
}
フィールド
courseId

string

コースの識別子。

読み取り専用です。
courseWorkId

string

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

読み取り専用です。
id

string

Classroom によって割り当てられた生徒の提出物の識別子。これは、関連するコースの課題の提出の中でも独自性のあるものです。

読み取り専用です。
userId

string

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

読み取り専用です。
creationTime

string (Timestamp format)

この送信の作成時刻。生徒がこのアイテムにアクセスしていない場合は、未設定になることがあります。

読み取り専用です。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

この送信の最終更新日時。生徒がこのアイテムにアクセスしていない場合は、未設定になることがあります。

読み取り専用です。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
state

enum (SubmissionState)

この送信の状態。

読み取り専用です。
late

boolean

この送信が遅延しているかどうか。

読み取り専用です。
draftGrade

number

オプションの保留中の成績です。未設定の場合、成績は設定されません。負の値は指定できません。小数値（整数以外の値）も使用できますが、小数点以下 2 桁に丸められます。

これはコースの教師だけが表示、変更できます。
assignedGrade

number

成績は任意です。未設定の場合、成績は設定されません。負の値は指定できません。小数値（整数以外の値）も使用できますが、小数点以下 2 桁に丸められます。

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

string

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

ルーブリックがない場合、この 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 機能にアクセスするには、設定する必要があります。
共用体フィールド content。送信内容。具体的な型は、course_work_type の値によって異なります。content は次のいずれかになります。
assignmentSubmission

object (AssignmentSubmission)

コース WorkType が ASSIGNMENT の場合の送信コンテンツ。

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

object (ShortAnswerSubmission)

コース WorkType が SHORT_ANSWER_QUESTION の場合の送信コンテンツ。
multipleChoiceSubmission

object (MultipleChoiceSubmission)

コース WorkType が 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)

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

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

添付ファイル

生徒の課題の課題に添付ファイルを追加しました。

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

JSON 表現 
{

  // Union field attachment can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field attachment.
}
フィールド
共用体フィールド attachment。添付ファイルのデータ。attachment は次のいずれかになります。
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 表現 
{

  // Union field type can be only one of the following:
  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
  // End of list of possible types for union field type.
}
フィールド
共用体フィールド type。Issue History のタイプ。StateHistory または GradHistory のいずれかです。type は次のいずれかになります。
stateHistory

object (StateHistory)

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

object (GradeHistory)

提出物の成績履歴情報（存在する場合）。

StateHistory

この送信に関する各ステータスの履歴。

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

enum (State)

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

string (Timestamp format)

送信がこのステータスになったとき。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
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)

提出物の成績が変更された日時。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
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

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