- 資源: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 |
課程的 ID。 唯讀。 |
courseWorkId |
對應課程作業的 ID。 唯讀。 |
id |
Classroom 針對學生繳交的作業指派的 ID。這與相關課程作業的提交內容不得重複。 唯讀。 |
userId |
擁有這項繳交作業的學生 ID。 唯讀。 |
creationTime |
此提交內容的建立時間。如果學生尚未存取這個項目,可以取消設定。 唯讀。 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
updateTime |
此提交內容的上次更新時間。如果學生尚未存取這個項目,可以取消設定。 唯讀。 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
state |
這份提交內容的狀態。 唯讀。 |
late |
這份提交內容是否為遲交。 唯讀。 |
draftGrade |
選填的待評分。如未設定,則未設定成績。這個值不得為負數。系統允許使用小數 (亦即非整數) 值,但將四捨五入至小數點後兩位。 只有課程老師才能查看及修改這項資訊。 |
assignedGrade |
選填成績。如未設定,則未設定成績。這個值不得為負數。系統允許使用小數 (亦即非整數) 值,但將四捨五入至小數點後兩位。 只有課程老師可以修改這項設定。 |
rubricId |
僅供輸出。這個課程作業目前附加的評分量表 ID,用於為這份學生繳交的作業評分。 如果沒有評分量表,這個 ID 會留空。這個 ID 反映了目前使用中的評分量表;如果老師刪除並重新建立評分量表,則會改變。 唯讀。 |
draftRubricGrades |
根據評分量表條件計算尚有待定的評分量表成績。 如果這個課程作業沒有附加評分量表,或是已附加評分量表,但未設定任何條件的成績,這份地圖就不會顯示任何內容。系統只會針對已設定的成績填入資料。索引鍵:評分量表的條件 ID。 唯讀。 這個物件中包含 |
assignedRubricGrades |
根據評分量表的條件指派的評分量表分數。 如果這個課程作業沒有附加評分量表,或是已附加評分量表,但未在任何條件中設定成績,這份地圖就不會顯示任何內容。系統只會針對已設定的成績填入資料。索引鍵:評分量表的條件 ID。 唯讀。 這個物件中包含 |
alternateLink |
Classroom 網頁使用者介面中的提交作業絕對連結。 唯讀。 |
courseWorkType |
這份繳交作業的課程類型。 唯讀。 |
associatedWithDeveloper |
這位學生提交的內容是否與提出要求的開發人員控制台專案相關聯。 詳情請參閱 唯讀。 |
submissionHistory[] |
繳交記錄 (包括狀態和成績記錄)。 唯讀。 |
previewVersion |
僅供輸出。API 的預覽版本。您必須進行這項設定,才能存取「搶先體驗方案」中為開發人員提供的新 API 功能。 |
聯集欄位 content 。提交內容。特定類型取決於 course_work_type 的值。content 只能採用下列其中一種設定: |
|
assignmentSubmission |
classWorkType 為 ASSIGNMENT 時提交內容。 學生可以使用 |
shortAnswerSubmission |
classWorkType 為 SHORT_ANSWER_QUESTION 時提交內容。 |
multipleChoiceSubmission |
classWorkType 為 MULTIPLE_CHOICE_QUESTION 時提交內容。 |
RubricGrade
已針對學生繳交的作業設定評分量表。每個評分量表條件最多一個項目。
JSON 表示法 |
---|
{ "criterionId": string, "levelId": string, "points": number } |
欄位 | |
---|---|
criterionId |
選用設定。條件 ID。 |
levelId |
選用設定。所選層級的選用等級 ID,如果留空,表示未選取任何等級。 |
points |
選用設定。指派給這項條件的選用分數,通常以等級為依據。等級不一定會有積分。如果未設定,系統就不會為這項條件設定任何分數。 |
AssignmentSubmission
學生寫作業。
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 |
學生回答簡答問題。 |
MultipleChoiceSubmission
學生完成選擇題的答案。
JSON 表示法 |
---|
{ "answer": string } |
欄位 | |
---|---|
answer |
學生選取選項。 |
SubmissionHistory
提交記錄。目前包括狀態和成績記錄。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 type 。SubmissionHistory 類型可以是 StateHistory 或 GradeHistory。type 只能是下列其中一項: |
|
stateHistory |
提交項目的狀態記錄資訊 (如果有的話)。 |
gradeHistory |
繳交作業的成績記錄資訊 (如果有的話)。 |
StateHistory
提交這份作品的各州記錄。
JSON 表示法 |
---|
{
"state": enum ( |
欄位 | |
---|---|
state |
工作流程管道階段。 |
stateTimestamp |
提交內容進入這個狀態時。 RFC3339 世界標準時間「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 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
actorUserId |
變更成績的老師。 |
gradeChangeType |
作業成績記錄中目前的成績類型變更。 |
GradeChangeType
可能的成績變更類型。
列舉 | |
---|---|
UNKNOWN_GRADE_CHANGE_TYPE |
未指定成績變更類型。不應傳回這個符號。 |
DRAFT_GRADE_POINTS_EARNED_CHANGE |
暫定成績的分子變更。 |
ASSIGNED_GRADE_POINTS_EARNED_CHANGE |
已指派成績的分子有所變更。 |
MAX_POINTS_CHANGE |
成績分母的變化。 |
方法 |
|
---|---|
|
發還學生繳交的作業。 |
|
傳回要求者可查看的學生繳交作業清單,並將要求的 OAuth 範圍納入考量。 |
|
修改學生繳交作業的附件。 |
|
更新一或多個學生繳交作業的欄位。 |
|
代表學生重新繳交作業。 |
|
發還學生繳交的作業。 |
|
學生繳交作業。 |