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

  // 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 によって割り当てられた ID。これは、関連するコースワークの提出物の中で一意のものである必要があります。

読み取り専用です。
userId

string

この提出物の所有者である生徒の ID。

読み取り専用です。
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 は空になります。この ID は、現在アクティブな評価尺度を反映しています。教師が評価尺度を削除して再作成すると、この ID は変更されます。

読み取り専用。
draftRubricGrades

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

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

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

読み取り専用です。

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

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

ルーブリックの条件に基づいて割り当てられたルーブリックの評価。

このコースワークに採点基準が添付されていない場合、または採点基準が添付されていても基準に成績が設定されていない場合、このマップは空になります。エントリは、設定された成績に対してのみ入力されます。Key: 評価基準の条件 ID。

読み取り専用です。

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

enum (CourseWorkType)

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

読み取り専用です。
associatedWithDeveloper

boolean

この生徒の提出物が、リクエストを行っているデベロッパー コンソール プロジェクトに関連付けられているかどうか。

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

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

object (SubmissionHistory)

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

読み取り専用です。
previewVersion

enum (PreviewVersion)

出力専用。API のプレビュー バージョン。プレビュー プログラムでデベロッパーが利用できる新しい API 機能にアクセスするには、このフラグを設定する必要があります。
共用体フィールド content。送信内容。具体的なタイプは course_work_type の値によって異なります。content は次のいずれかになります。
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)

生徒が追加した添付ファイル。生徒が 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。SubmissionHistory のタイプ。StateHistory または GradeHistory のいずれかです。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

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