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 で割り当てられた識別子。これは、関連するコースワークの提出物の中で一意です。

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

保留中の成績（省略可）。設定されていない場合は、成績が設定されていません。この値は非負である必要があります。小数（整数以外の値）は使用できますが、小数点第 2 位に丸められます。

これはコースの教師のみが確認および変更できます。
assignedGrade

number

省略可能なグレード。設定されていない場合は、成績が設定されていません。この値は非負である必要があります。小数（整数以外の値）は使用できますが、小数点第 2 位に丸められます。

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

string

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

ルーブリックがない場合、この 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 機能にアクセスするには、この設定を行う必要があります。
共用体フィールド 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)

送信がこの状態になった日時。

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

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