- リソース: StudentSubmission
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- RubricGrade
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- AssignmentSubmission
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- 添付ファイル
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- ShortAnswerSubmission
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- MultipleChoiceSubmission
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- SubmissionHistory
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- StateHistory
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- 州名
- GradeHistory
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- GradeChangeType
- メソッド
リソース: StudentSubmission
課題に対する生徒の提出物。
CourseWork
アイテムを作成すると、StudentSubmission
個のアイテムが生成されます。
生徒の提出物に一度もアクセスしたことがない(例: state
= 新規)場合、作成日時や更新日時を指定することはできません。
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[] |
生徒が追加した添付ファイル。生徒が Classroom で課題にアクセスしていない場合、共有モードが STUDENT_COPY の教材に対応するドライブ ファイルがまだ存在していない可能性があります。 一部の添付ファイルのメタデータは、リクエスト元のユーザーにアクセス権限がある場合にのみ入力されます。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 。Issue History のタイプ。StateHistory または GradHistory のいずれかです。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 |
成績の分母の変更。 |
メソッド |
|
---|---|
|
生徒の提出物を返します。 |
|
リクエストの OAuth スコープを考慮して、リクエスト元に閲覧が許可されている生徒の提出物のリストを返します。 |
|
生徒の提出物の添付ファイルを変更します。 |
|
生徒の提出物の 1 つ以上のフィールドを更新します。 |
|
生徒の提出物を所有する生徒に代わって、生徒の提出物を回収します。 |
|
生徒の提出物を返します。 |
|
生徒の提出物を提出します。 |