- リソース: StudentSubmission
- SubmissionState(提出ステータス)
- AssignmentSubmission
- 添付ファイル
- ShortAnswerSubmission
- MultipleChoiceSubmission
- SubmissionHistory
- StateHistory
- ステータス
- GradeHistory
- GradeChangeType
- Methods
リソース: StudentSubmission
生徒が課題を提出するためのコースです。
StudentSubmission アイテムは、CourseWork アイテムの作成時に生成されます。
アクセスされていない StudentSubmissions(state
= NEW)には、作成日時または更新日時が設定されていない可能性があります。
JSON 表現 |
---|
{ "courseId": string, "courseWorkId": string, "id": string, "userId": string, "creationTime": string, "updateTime": string, "state": enum ( |
フィールド | |
---|---|
courseId |
コースの識別子。 読み取り専用。 |
courseWorkId |
対応するコース課題の識別子です。 読み取り専用。 |
id |
生徒の提出物に Classroom で割り当てられた ID。これは、関連するコース課題の提出物ごとに一意です。 読み取り専用。 |
userId |
この提出物を所有する生徒の ID。 読み取り専用。 |
creationTime |
この送信時間の作成日。生徒がこのアイテムにアクセスしていない場合は、未設定になる可能性があります。 読み取り専用。 RFC3339 UTC & Zulu 形式のタイムスタンプ(解像度はナノ秒、小数点以下 9 桁まで)。(例: |
updateTime |
この送信の最終更新日時です。生徒がこのアイテムにアクセスしていない場合は、未設定になる可能性があります。 読み取り専用。 RFC3339 UTC & Zulu 形式のタイムスタンプ(解像度はナノ秒、小数点以下 9 桁まで)。(例: |
state |
この送信の状態。 読み取り専用。 |
late |
送信が遅れたかどうか。 読み取り専用。 |
draftGrade |
保留中の成績(省略可)。未設定の場合、成績は設定されません。負の値を指定することはできません。小数点以下の値も使用できますが、小数点以下 2 桁に四捨五入されます。 これはコースの教師のみが表示し、変更できます。 |
assignedGrade |
(省略可)成績。未設定の場合、成績は設定されません。負の値を指定することはできません。小数点以下の値も使用できますが、小数点以下 2 桁に四捨五入されます。 これはコースの講師のみが変更できます。 |
alternateLink |
Classroom ウェブ UI で提出内容への絶対リンク。 読み取り専用。 |
courseWorkType |
提出する課題のタイプ。 読み取り専用。 |
associatedWithDeveloper |
この生徒の提出物が、リクエストを行っている Play Console プロジェクトに関連付けられているかどうか。 詳しくは、 読み取り専用。 |
submissionHistory[] |
提出履歴(状態の履歴と成績の履歴を含む)。 読み取り専用。 |
共用体フィールド content 。提出コンテンツ。具体的な型は、course_work_type の値によって異なります。content は次のいずれかになります。 |
|
assignmentSubmission |
courseWorkType が ASSIGNMENT の場合の送信コンテンツ。 生徒は |
shortAnswerSubmission |
courseWorkType が SHORT_ANSWER_QUESTION の場合の送信コンテンツ。 |
multipleChoiceSubmission |
courseWorkType が MULTIPLE_CHOICE_QUESTION の場合は、送信コンテンツ。 |
提出ステータス
生徒の提出ステータス
列挙型 | |
---|---|
SUBMISSION_STATE_UNSPECIFIED |
状態が指定されていません。これは返されません。 |
NEW |
生徒がこの提出物にアクセスしたことがない。添付ファイルは返されず、タイムスタンプは設定されません。 |
CREATED |
を作成しました。 |
TURNED_IN |
教師に提出済み。 |
RETURNED |
生徒に返却されました。 |
RECLAIMED_BY_STUDENT |
生徒が課題の [提出を取り消す] を選択しました。 |
課題の提出
生徒の課題(課題)。
JSON 表現 |
---|
{
"attachments": [
{
object ( |
フィールド | |
---|---|
attachments[] |
生徒が追加した添付ファイル。生徒が Classroom で課題にアクセスしていない場合、共有モード「STUDENT_COPY」が設定された資料に対応するドライブ ファイルは、まだ存在しない可能性があります。 一部の添付ファイルのメタデータは、リクエスト元のユーザーがそのファイルにアクセスする権限を持っている場合にのみ入力されます。ID と alternateLink 項目は常に使用できますが、それ以外の項目(title など)は使用できません。 |
アタッチメント
生徒の課題に添付ファイルを追加しました。
添付ファイルを作成する場合、form
フィールドの設定はサポートされていません。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド attachment 。添付ファイルのデータ。attachment は次のいずれかになります。 |
|
driveFile |
Google ドライブのファイルの添付ファイル。 |
youTubeVideo |
YouTube 動画添付ファイル。 |
link |
リンクの添付ファイル。 |
form |
Google フォームの添付ファイル。 |
ShortAnswerSubmission(ショート回答の提出)
記述式問題用の生徒の課題。
JSON 表現 |
---|
{ "answer": string } |
フィールド | |
---|---|
answer |
記述式問題に対する生徒の解答。 |
多肢選択式
多肢選択式の質問に対する生徒の課題。
JSON 表現 |
---|
{ "answer": string } |
フィールド | |
---|---|
answer |
生徒の選択。 |
送信履歴
送信履歴。現在、履歴や成績の履歴も含まれます。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド type 。SubmitHistory の種類。StateHistory、GradeHistory のいずれかを指定できます。type は次のいずれかになります。 |
|
stateHistory |
送信時の状態履歴情報(存在する場合)。 |
gradeHistory |
提出物の成績の履歴情報(存在する場合)。 |
州の履歴
この送信の状態の各履歴。
JSON 表現 |
---|
{
"state": enum ( |
フィールド | |
---|---|
state |
ワークフロー パイプラインのステージ。 |
stateTimestamp |
送信内容がこのステータスになったとき。 RFC3339 UTC & Zulu 形式のタイムスタンプ(解像度はナノ秒、小数点以下 9 桁まで)。(例: |
actorUserId |
変更を行った教師または生徒。 |
状態
送信されたステータス
列挙型 | |
---|---|
STATE_UNSPECIFIED |
状態が指定されていません。これは返されません。 |
CREATED |
提出物が作成されました。 |
TURNED_IN |
生徒は割り当てられたドキュメントを提出しました。テンプレートはテンプレートであるとは限りません。 |
RETURNED |
教師が課題を生徒に返却しました。 |
RECLAIMED_BY_STUDENT |
生徒が課題を提出し、課題の「提出を取り消して」を承諾すると、生徒は課題を再び主体的に管理できるようになりました。 |
STUDENT_EDITED_AFTER_TURN_IN |
生徒が提出後に課題を編集した。現在のところ、質問が生徒が解答を編集したときにのみ使用されます。 |
成績の履歴
この提出物の成績の履歴。
JSON 表現 |
---|
{
"pointsEarned": number,
"maxPoints": number,
"gradeTimestamp": string,
"actorUserId": string,
"gradeChangeType": enum ( |
フィールド | |
---|---|
pointsEarned |
この時点での提出物の成績履歴における成績の分子。 |
maxPoints |
提出物の成績履歴で、現在の成績の分母。 |
gradeTimestamp |
提出物の成績が変更された日時です。 RFC3339 UTC & Zulu 形式のタイムスタンプ(解像度はナノ秒、小数点以下 9 桁まで)。(例: |
actorUserId |
成績を変更した教師。 |
gradeChangeType |
提出物の成績履歴における、現在の成績変更の種類。 |
成績の変更タイプ
変更可能な成績のタイプ。
列挙型 | |
---|---|
UNKNOWN_GRADE_CHANGE_TYPE |
成績変更の種類が指定されていません。これは返されません。 |
DRAFT_GRADE_POINTS_EARNED_CHANGE |
仮成績の分子の変更。 |
ASSIGNED_GRADE_POINTS_EARNED_CHANGE |
割り当てられた成績の分子の変化。 |
MAX_POINTS_CHANGE |
成績の分母の変化。 |
Methods |
|
---|---|
|
生徒の提出物が返されます。 |
|
リクエストによる OAuth スコープを考慮し、リクエスト送信者に閲覧を許可する生徒の提出物の一覧を返します。 |
|
生徒の提出物の添付ファイルを変更します。 |
|
生徒の提出物の 1 つ以上のフィールドを更新します。 |
|
生徒の提出物を、生徒本人に代わって回収します。 |
|
生徒の提出物が返されます。 |
|
生徒の提出物を提出する。 |