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,每個課程均有專屬 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」格式的時間戳記,採用奈秒解析度,且最多 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

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