REST Resource: courses.courseWork.studentSubmissions

リソース: StudentSubmission

生徒がコースの課題を提出した。

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

アクセスしたことがない生徒の提出物(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 で割り当てられた生徒の提出物の識別子。これは、関連するコース課題の提出物の中で固有のものです。

読み取り専用です。

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)

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

一部の添付ファイルのメタデータは、リクエスト元のユーザーにアクセス権がある場合のみ入力されます。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 成績の分母の変化。

Methods

get

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

list

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

modifyAttachments

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

patch

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

reclaim

それを所有する生徒に代わって、生徒の提出物を再利用します。

return

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

turnIn

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