REST Resource: courses.courseWorkMaterials

資源:CourseWorkMaterial

老師為課程學生製作的課程作業教材

JSON 表示法
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkMaterialState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "scheduledTime": string,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "creatorUserId": string,
  "topicId": string
}
欄位
courseId

string

課程的 ID。

唯讀。

id

string

這個課程作業教材由 Classroom 指派的 ID,每個課程均不得重複。

唯讀。

title

string

這項課程作業教材的標題。標題必須是有效的 UTF-8 字串,長度必須介於 1 至 3,000 個字元之間。

description

string

(選填) 本課程教材說明。文字必須是有效的 UTF-8 字串,長度不得超過 30,000 個字元。

materials[]

object (Material)

其他資料。

課程作業教材最多只能有 20 件教材。

state

enum (CourseWorkMaterialState)

這項課程作業內容的狀態。如果未指定,則預設狀態為 DRAFT

creationTime

string (Timestamp format)

建立這項課程教材的時間戳記。

唯讀。

RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

最近一次變更這項課程作業教材的時間戳記。

唯讀。

RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

scheduledTime

string (Timestamp format)

這項課程教材預定發布的時間戳記 (選填)。

RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

assigneeMode

enum (AssigneeMode)

課程作業教材指派對像模式。如果未指定,則預設值為 ALL_STUDENTS

individualStudentsOptions

object (IndividualStudentsOptions)

擁有課程作業教材的學生 ID。只有在 assigneeModeINDIVIDUAL_STUDENTS 時,才會設定這個欄位。如果 assigneeModeINDIVIDUAL_STUDENTS,則只有這個欄位中指定的學生可以查看課程作業教材。

creatorUserId

string

建立課程教材的使用者 ID。

唯讀。

topicId

string

與這項課程教材相關聯的主題 ID。必須與課程中的現有主題相符。

CourseWorkMaterialState

課程作業的可能狀態

列舉
COURSEWORK_MATERIAL_STATE_UNSPECIFIED 未指定州。系統一律不會傳回這個值。
PUBLISHED 已發布的課程作業狀態。這是預設狀態。
DRAFT 尚未發布的課程作業狀態。只有課程老師和網域管理員才能查看這個狀態下的課程作業教材。
DELETED 課程教材中,已發布但尚未刪除的狀態。只有課程老師和網域管理員才能查看這個狀態下的課程作業教材。系統會在一段時間後刪除處於這個狀態的課程教材。

方法

create

建立課程作業教材。

delete

刪除課程作業教材。

get

傳回課程作業教材。

getAddOnContext

取得特定訊息背景資訊的 Classroom 外掛程式中繼資料。

list

傳回要求者有權檢視的課程作業內容清單。

patch

更新課程作業教材的一或多個欄位。