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

string

课堂为此课程作业资料分配的标识符,每个课程都是唯一的。

只读。

title

string

此课程作业资料的标题。标题必须是有效的 UTF-8 字符串,长度介于 1 到 3000 个字符之间。

description

string

此课程作业资料的可选说明。该文本必须是一个有效的 UTF-8 字符串,且长度不超过 3 万个字符。

materials[]

object (Material)

其他资料。

课程作业资料中的资料项不得超过 20 项。

state

enum (CourseWorkMaterialState)

本课程作业资料的状态。如果未指定,则默认状态为 DRAFT

creationTime

string (Timestamp format)

创建此课程作业资料时的时间戳。

只读。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

此课程作业资料最近更改的时间戳。

只读。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

scheduledTime

string (Timestamp format)

(可选)此课程作业资料计划发布的时间戳。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

assigneeMode

enum (AssigneeMode)

课程作业资料的分配对象模式。如果未指定,则默认值为 ALL_STUDENTS

individualStudentsOptions

object (IndividualStudentsOptions)

有权访问课程作业资料的学生的标识符。仅当 assigneeModeINDIVIDUAL_STUDENTS 时,才会设置此字段。如果 assigneeModeINDIVIDUAL_STUDENTS,则只有此字段中指定的学生才能查看课程作业资料。

creatorUserId

string

创建课程作业资料的用户的标识符。

只读。

topicId

string

与本课程作业资料关联的主题的标识符。必须与课程中的现有主题一致。

CourseWorkMaterialState

课程作业资料的可能状态

枚举
COURSEWORK_MATERIAL_STATE_UNSPECIFIED 未指定状态。且永远不会返回。
PUBLISHED 已发布的课程作业资料的状态。这是默认状态。
DRAFT 课程作业资料尚未发布的状态。此状态下的课程作业资料仅对课程教师和网域管理员可见。
DELETED 已发布但现已删除的课程作业资料的状态。此状态下的课程作业资料仅对课程教师和网域管理员可见。处于此状态的课程作业资料会在一段时间后被删除。

方法

create

创建课程作业资料。

delete

删除课程作业资料。

get

返回课程作业资料。

getAddOnContext

获取特定帖子上下文中 Google 课堂插件的元数据。

list

返回允许请求者查看的课程作业资料列表。

patch

更新课程作业资料的一个或多个字段。