資源:CourseWork
由老師為課程學生建立的課程作業。
JSON 表示法 |
---|
{ "courseId": string, "id": string, "title": string, "description": string, "materials": [ { object ( |
欄位 | |
---|---|
courseId |
課程的 ID。 唯讀。 |
id |
這項課程作業透過 Classroom 指派的 ID,每個課程均不得重複。 唯讀。 |
title |
這門課程的標題。標題必須是有效的 UTF-8 字串,長度必須介於 1 至 3,000 個字元之間。 |
description |
課程作業的說明 (選填)。如要設定,說明必須是有效的 UTF-8 字串,且長度不得超過 30,000 個字元。 |
materials[] |
其他資料。 CourseWork 最多只能包含 20 個教材項目。 |
state |
這項課程作業的狀態。如果未指定,則預設狀態為 |
alternateLink |
Classroom 網頁 UI 中的本課程作業絕對連結。只有在 唯讀。 |
creationTime |
這項課程作業建立的時間戳記。 唯讀。 RFC3339 世界標準時間「Zulu」格式的時間戳記,解析度以奈秒為單位,小數點後最多 9 位。範例: |
updateTime |
最近一次變更這項課程作業的時間戳記。 唯讀。 RFC3339 世界標準時間「Zulu」格式的時間戳記,解析度以奈秒為單位,小數點後最多 9 位。範例: |
dueDate |
(選填) 這項課程作業的繳交期限 (世界標準時間)。如果指定 |
dueTime |
(選填) 這堂課程作業的繳交期限 (世界標準時間)。如果指定 |
scheduledTime |
已排定發布這項課程作業的時間戳記。 RFC3339 世界標準時間「Zulu」格式的時間戳記,解析度以奈秒為單位,小數點後最多 9 位。範例: |
maxPoints |
這個課程作業的最高成績。如果作業為 0 或未指定,即視為未評分。必須為非負整數。 |
workType |
這門課程的類型。 類型會在建立課程作業時設定,而且無法變更。 |
associatedWithDeveloper |
此課程作業項目是否與提出要求的 Developer Console 專案相關聯。 詳情請參閱 唯讀。 |
assigneeMode |
課程作業的指派對像模式。如果未指定,則預設值為 |
individualStudentsOptions |
擁有課程作業存取權的學生 ID。只有在 |
submissionModificationMode |
決定學生何時可以修改繳交作業的設定。如果未指定,則預設值為 |
creatorUserId |
建立課程作業的使用者 ID。 唯讀。 |
topicId |
與這項課程相關聯的主題 ID。必須與課程中的現有主題相符。 |
gradeCategory |
此課程作業的成績類別。只有在已經選定課程作業類別時才會顯示。可用來計算總成績。 唯讀。 |
previewVersion |
僅供輸出。用來擷取這項資源的 API 預覽版本。 |
聯集欄位 details 。特定課程作業類型的其他詳細資料。details 只能是下列其中一項: |
|
assignment |
作業詳細資料。只有在 唯讀。 |
multipleChoiceQuestion |
選擇題詳細資料。針對讀取作業,只有在 |
gradingPeriodId |
與課程作業相關聯的評分期間 ID。
|
CourseWorkState
課程作業的可能狀態。
列舉 | |
---|---|
COURSE_WORK_STATE_UNSPECIFIED |
未指定州。系統一律不會傳回這個值。 |
PUBLISHED |
已發布作業的狀態。這是預設狀態。 |
DRAFT |
尚未發布的作業狀態。只有課程老師和網域管理員才能查看這個狀態的作業。 |
DELETED |
工作狀態:已發布,但現已遭到刪除。只有課程老師和網域管理員才能查看這個狀態的作業。處於這個狀態的工作會在一段時間後刪除。 |
SubmissionModificationMode
學生繳交作業時可用的修改模式。
列舉 | |
---|---|
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED |
未指定修改模式。系統一律不會傳回這個值。 |
MODIFIABLE_UNTIL_TURNED_IN |
您可以在繳交作業前修改繳交的作業。 |
MODIFIABLE |
提交內容隨時都可以修改。 |
指派項目
作業的其他詳細資料。
JSON 表示法 |
---|
{
"studentWorkFolder": {
object ( |
欄位 | |
---|---|
studentWorkFolder |
存放學生繳交附件的雲端硬碟資料夾。只有課程的老師和管理員才看得到這項資訊。 |
MultipleChoiceQuestion
選擇題的其他詳細資料。
JSON 表示法 |
---|
{ "choices": [ string ] } |
欄位 | |
---|---|
choices[] |
可能的選項。 |
方法 |
|
---|---|
|
建立課程作業。 |
|
刪除課程作業。 |
|
傳回課程作業。 |
|
取得特定訊息背景資訊的 Classroom 外掛程式中繼資料。 |
|
傳回要求者有權檢視的課程作業清單。 |
|
修改課程作業的指派模式和選項。 |
|
更新課程作業的一或多個欄位。 |