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 至 3000 個半形字元之間。

description

string

此課程作業材料的選用說明。文字必須是有效的 UTF-8 字串,且長度不得超過 30,000 個半形字元。

materials[]

object (Material)

其他材料。

課程工作材料最多只能包含 20 個內容項目。

state

enum (CourseWorkMaterialState)

本課程作業材料的狀態。如果未指定,則預設狀態為 DRAFT

creationTime

string (Timestamp format)

建立這項課程作業材料的時間戳記。

唯讀。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

本課程作業資料最近一次變更的時間戳記。

唯讀。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

scheduledTime

string (Timestamp format)

這個課程作業材料的發布時間 (選填)。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 "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

更新課程工作素材的一或多個欄位。