REST Resource: courses.courseWork

资源:CourseWork

教师为课程中的学生创建的课程作业。

JSON 表示法
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },

  // Union field details can be only one of the following:
  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  // End of list of possible types for union field details.
}
字段
courseId

string

课程的标识符。

只读。

id

string

由课堂分配的此课程作业的标识符,每门课程的唯一标识符。

只读。

title

string

本课程作业的标题。标题必须是包含 1 到 3000 个字符的有效 UTF-8 字符串。

description

string

此课程作业的可选说明。如果已设置,说明必须是不超过 30,000 个字符的有效 UTF-8 字符串。

materials[]

object (Material)

其他资料。

CourseWork 的实质性内容不得超过 20 个。

state

enum (CourseWorkState)

此课程作业的状态。如果未指定,则默认状态为 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"

dueDate

object (Date)

此课程作业的提交截止日期(可选,采用世界协调时间)。如果指定了 dueTime,则必须指定此字段。

dueTime

object (TimeOfDay)

此课程作业的提交截止时间(可选),采用世界协调时间 (UTC)。如果指定了 dueDate,则必须指定此字段。

scheduledTime

string (Timestamp format)

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

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

maxPoints

number

此课程作业的最高成绩。如果该值为零或未指定,则此作业将被视为不计分。该值必须是非负整数值。

workType

enum (CourseWorkType)

此课程作业的类型。

类型是在创建课程作业时设置的,无法更改。

associatedWithDeveloper

boolean

此课程工作项是否与发出请求的 Play 管理中心项目相关联。

如需了解详情,请参阅 courseWork.create

只读。

assigneeMode

enum (AssigneeMode)

课程作业的被分配者模式。如果未指定,则默认值为 ALL_STUDENTS

individualStudentsOptions

object (IndividualStudentsOptions)

有权访问课程作业的学生的标识符。仅当 assigneeModeINDIVIDUAL_STUDENTS 时,才会设置此字段。如果 assigneeMode 为“INDIVIDUAL_STUDENTS”,则系统只会向此字段中指定的学生分配课程作业。

submissionModificationMode

enum (SubmissionModificationMode)

此设置用于确定学生何时可以修改提交内容。如果未指定,则默认值为 MODIFIABLE_UNTIL_TURNED_IN

creatorUserId

string

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

只读。

topicId

string

此课程作业关联的主题的标识符。必须与课程中的现有主题匹配。

gradeCategory

object (GradeCategory)

此课程作业的成绩所属的类别。仅当为课程作业选择了类别时展示。可用于计算总体成绩。

只读。

联合字段 details。针对某一类课程作业的其他详细信息。details 只能是下列其中一项:
assignment

object (Assignment)

分配任务详情。仅当 workTypeASSIGNMENT 时,系统才会填充此字段。

只读。

multipleChoiceQuestion

object (MultipleChoiceQuestion)

单选题详细信息。对于读取操作,仅当 workTypeMULTIPLE_CHOICE_QUESTION 时才会填充此字段。对于写入操作,使用 MULTIPLE_CHOICE_QUESTIONworkType创建课程作业时必须指定此字段,且不得以其他方式设置此字段。

CourseWorkState

课程作业的可能状态。

枚举
COURSE_WORK_STATE_UNSPECIFIED 未指定任何州。此值永远不会返回。
PUBLISHED 已发布作品的状态。这是默认状态。
DRAFT 尚未发布的作业的状态。只有课程教师和网域管理员可以看到此状态下的作业。
DELETED 已发布但现已删除的作品的状态。只有课程教师和网域管理员可以看到此状态下的作业。处于此状态的作业会在一段时间后被删除。

SubmissionModificationMode

学生提交的作业可能的修改模式。

枚举
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED 未指定修改模式。此值永远不会返回。
MODIFIABLE_UNTIL_TURNED_IN 您可以在上交前修改提交的作业。
MODIFIABLE 您可以随时修改提交的内容。

分配

有关分配的其他详细信息。

JSON 表示法
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
字段
studentWorkFolder

object (DriveFolder)

云端硬盘文件夹,用于存放学生提交的作业中的附件。只有课程教师和管理员才会填充此字段。

MultipleChoiceQuestion

关于选择题的其他详细信息。

JSON 表示法
{
  "choices": [
    string
  ]
}
字段
choices[]

string

可能的选项。

方法

create

创建课程作业。

delete

删除课程作业。

get

返回课程作业。

getAddOnContext

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

list

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

modifyAssignees

修改分配对象模式和课程作业选项。

patch

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