- リソース: StudentSubmission
- RubricGrade
- AssignmentSubmission
- 添付ファイル
- ShortAnswerSubmission
- MultipleChoiceSubmission
- SubmissionHistory
- StateHistory
- ステータス
- GradeHistory
- GradeChangeType
- メソッド
リソース: StudentSubmission
生徒がコースの課題を提出した。
CourseWork
アイテムが作成されると、StudentSubmission
アイテムが生成されます。
アクセスしたことがない生徒の提出物(state
= NEW など)には、作成日時や更新日時がない場合があります。
JSON 表現 |
---|
{ "courseId": string, "courseWorkId": string, "id": string, "userId": string, "creationTime": string, "updateTime": string, "state": enum ( |
フィールド | |
---|---|
courseId |
コースの識別子。 読み取り専用です。 |
courseWorkId |
対応するコース課題の識別子。 読み取り専用です。 |
id |
Classroom で割り当てられた生徒の提出物の識別子。これは、関連するコース課題の提出物の中で固有のものです。 読み取り専用です。 |
userId |
この提出物のオーナーである生徒の識別子。 読み取り専用です。 |
creationTime |
この送信の作成日時。生徒がこのアイテムにまだアクセスしていない場合は、未設定のままにすることができます。 読み取り専用です。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
updateTime |
この送信の最終更新日時。生徒がこのアイテムにまだアクセスしていない場合は、未設定のままにすることができます。 読み取り専用です。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
state |
この送信の状態。 読み取り専用です。 |
late |
この送信が遅れているかどうか。 読み取り専用です。 |
draftGrade |
保留中の成績(省略可)。未設定のままにした場合、成績は設定されません。この値は負の値にしないでください。小数(つまり整数以外の)値も使用できますが、小数点以下 2 桁に四捨五入されます。 これはコースの教師のみが表示し、変更を加えることができます。 |
assignedGrade |
任意成績です。未設定のままにした場合、成績は設定されません。この値は負の値にしないでください。小数(つまり整数以外の)値も使用できますが、小数点以下 2 桁に四捨五入されます。 これを変更できるのはコースの教師のみです。 |
rubricId |
出力のみ。現在このコースの課題に添付されており、この生徒の提出物の採点に使用されているルーブリックの識別子。 ルーブリックがない場合、この ID は空です。この ID は、現在アクティブなルーブリックを反映しています。教師がルーブリックを削除して再作成すると変化します。 読み取り専用。 |
draftRubricGrades |
ルーブリックの基準に基づく、保留中のルーブリック成績。 このコースの課題にルーブリックが添付されていない場合や、ルーブリックが添付されているがどの基準にも成績が設定されていない場合、この地図は空になります。設定されている成績のみが入力されます。キー: ルーブリックの条件 ID。 読み取り専用。
|
assignedRubricGrades |
ルーブリックの基準に基づいて割り当てられたルーブリックの成績。 このコースの課題にルーブリックが添付されていない場合や、ルーブリックが添付されているがどの基準にも成績が設定されていない場合、この地図は空です。設定されている成績のみが入力されます。キー: ルーブリックの条件 ID。 読み取り専用。
|
alternateLink |
Classroom ウェブ UI での提出物への絶対リンク。 読み取り専用です。 |
courseWorkType |
この提出の対象となるコースの課題の種類。 読み取り専用です。 |
associatedWithDeveloper |
この生徒の提出物が、リクエストを行っている Developer Console プロジェクトに関連付けられているかどうか。 詳しくは、 読み取り専用です。 |
submissionHistory[] |
提出物の履歴(状態と成績の履歴を含む)。 読み取り専用です。 |
previewVersion |
出力のみ。API のプレビュー版。プレビュー プログラムでデベロッパーが利用できる新しい API 機能にアクセスするには、設定する必要があります。 |
共用体フィールド content 。応募内容。具体的なタイプは、course_work_type の値によって異なります。content は次のいずれかになります。 |
|
assignmentSubmission |
コース WorkType が ASSIGNMENT の場合にコンテンツを提出します。 生徒は |
shortAnswerSubmission |
コース WorkType が SHORT_ANSWER_QUESTION の場合にコンテンツを提出してください。 |
multipleChoiceSubmission |
コース WorkType が MULTIPLE_CHOICE_QUESTION の場合はコンテンツを提出してください。 |
RubricGrade
生徒の提出物に設定されたルーブリックの成績。ルーブリックの基準ごとに最大 1 件のエントリがあります。
JSON 表現 |
---|
{ "criterionId": string, "levelId": string, "points": number } |
フィールド | |
---|---|
criterionId |
(省略可)条件 ID。 |
levelId |
(省略可)選択したレベルのオプションのレベル ID。空の場合、レベルは選択されていません。 |
points |
(省略可)この基準に割り当てられるオプションの点で、通常はレベルに基づいて割り当てられます。レベルにはポイントが付いていない場合と、ない場合があります。未設定のままにした場合、この条件のポイントは設定されません。 |
AssignmentSubmission
生徒が提出した課題。
JSON 表現 |
---|
{
"attachments": [
{
object ( |
フィールド | |
---|---|
attachments[] |
生徒が追加した添付ファイル。共有モードが STUDENT_COPY である教材に対応するドライブのファイルは、生徒が Classroom で課題にアクセスしていない場合は、まだ存在しない可能性があります。 一部の添付ファイルのメタデータは、リクエスト元のユーザーにアクセス権がある場合のみ入力されます。Identifier フィールドと alternateLink フィールドは常に利用できますが、他のフィールド(title など)は利用できない場合があります。 |
愛着
生徒の課題の提出物に添付ファイルを追加しました。
アタッチメントを作成する場合、form
フィールドの設定はサポートされていません。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド attachment 。添付ファイルのデータ。attachment は次のいずれかになります。 |
|
driveFile |
Google ドライブのファイル添付ファイル。 |
youTubeVideo |
YouTube 動画添付ファイル。 |
link |
リンクの添付ファイル。 |
form |
Google フォームの添付ファイル。 |
ShortAnswerSubmission
記述式問題に取り組む生徒の課題。
JSON 表現 |
---|
{ "answer": string } |
フィールド | |
---|---|
answer |
記述式問題に対する生徒の回答。 |
MultipleChoiceSubmission
多肢選択式の質問に取り組む生徒の提出物。
JSON 表現 |
---|
{ "answer": string } |
フィールド | |
---|---|
answer |
学生の選択。 |
SubmissionHistory
送信履歴。現在のところ、これには州や成績の履歴が含まれます。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド type 。SubmissionHistory のタイプ。StateHistory または GradeHistory のいずれかです。type は次のいずれかになります。 |
|
stateHistory |
送信の状態の履歴情報(存在する場合)。 |
gradeHistory |
提出物の成績履歴情報(存在する場合)。 |
StateHistory
この送信があった各状態の履歴。
JSON 表現 |
---|
{
"state": enum ( |
フィールド | |
---|---|
state |
ワークフロー パイプラインのステージ。 |
stateTimestamp |
送信がこのステータスになった日時。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
actorUserId |
変更を行った教師または生徒。 |
状態
投稿の状態。
列挙型 | |
---|---|
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 ( |
フィールド | |
---|---|
pointsEarned |
提出物の成績履歴内での現時点の成績の分子。 |
maxPoints |
提出物の成績履歴における、現時点での成績の分母。 |
gradeTimestamp |
提出物の成績が変更された日時。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
actorUserId |
成績を変更した教師。 |
gradeChangeType |
提出物の成績履歴における、現時点での成績の変更の種類。 |
GradeChangeType
利用可能な成績の変更の種類。
列挙型 | |
---|---|
UNKNOWN_GRADE_CHANGE_TYPE |
成績変更のタイプが指定されていません。これは返されません。 |
DRAFT_GRADE_POINTS_EARNED_CHANGE |
仮成績の分子の変更。 |
ASSIGNED_GRADE_POINTS_EARNED_CHANGE |
割り当てられた成績の分子の変更。 |
MAX_POINTS_CHANGE |
成績の分母の変化。 |
Methods |
|
---|---|
|
生徒の提出物を返します。 |
|
リクエストの OAuth スコープを考慮して、リクエスト元が閲覧を許可されている生徒の提出物のリストを返します。 |
|
生徒の提出物の添付ファイルを修正します。 |
|
生徒の提出物の 1 つ以上のフィールドを更新します。 |
|
それを所有する生徒に代わって、生徒の提出物を再利用します。 |
|
生徒の提出物を返します。 |
|
生徒からの提出物を提出します。 |