資源:CourseWork
老師為課程學生建立的課程作業。
JSON 表示法 |
---|
{ "courseId": string, "id": string, "title": string, "description": string, "materials": [ { object ( |
欄位 | |
---|---|
courseId |
課程的 ID。 唯讀。 |
id |
Classroom 指派給這個課程作業的 ID,每個課程均不得重複。 唯讀。 |
title |
課程作業的標題。標題必須是 UTF-8 字串,且長度必須介於 1 至 3000 個字元之間。 |
description |
此為本課程作業的說明 (選填)。如有設定,則說明必須是有效的 UTF-8 字串,且最多只能包含 30,000 個半形字元。 |
materials[] |
其他資料。 CourseWork 最多只能包含 20 個教材項目。 |
state |
這個課程作業的狀態。如果未指定,則預設狀態為 |
alternateLink |
Classroom 網頁版使用者介面中的課程作業絕對連結。只有在 唯讀。 |
creationTime |
建立這個課程作業時的時間戳記。 唯讀。 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
updateTime |
此課程作業最近變更的時間戳記。 唯讀。 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
dueDate |
這項課程作業的繳交期限 (選用日期,以世界標準時間為準)。如果已指定 |
dueTime |
這項課程作業的交件期限 (選用) (使用世界標準時間)。如果已指定 |
scheduledTime |
(選填) 這課程作業預定發布時的時間戳記。 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
maxPoints |
這項課程作業的最高成績。如未指定或未指定,作業將視為未評分。此值必須為非負整數。 |
workType |
這個課程作業的類型。 類型會在建立課程作業時設定,而且無法變更。 |
associatedWithDeveloper |
這個課程工作項目是否與提出要求的開發人員控制台專案相關聯。 詳情請參閱 唯讀。 |
assigneeMode |
課程作業的指派對像模式。如果未指定,則預設值為 |
individualStudentsOptions |
具有課程作業存取權的學生 ID。只有在 |
submissionModificationMode |
這項設定可決定學生何時可以修改繳交的作業。如果未指定,則預設值為 |
creatorUserId |
建立課程作業的使用者 ID。 唯讀。 |
topicId |
與這項課程相關聯的主題 ID。必須與課程中的現有主題相符。 |
gradeCategory |
這項課程的成績所屬的類別。只有在已選擇課程作業的類別時才會顯示。可用於計算總成績。 唯讀。 |
聯集欄位 details 。特定課程作業類型專屬的其他詳細資料。details 只能是下列其中一項: |
|
assignment |
作業詳細資料。只有在 唯讀。 |
multipleChoiceQuestion |
選擇題問題詳細說明。如果是讀取作業,只有在 |
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 外掛程式與特定訊息相關的中繼資料。 |
|
傳回允許要求者查看的課程作業清單。 |
|
修改課程的指派對像模式和選項。 |
|
更新課程作業的一或多個欄位。 |