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)
  },
  "previewVersion": enum (PreviewVersion),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "gradingPeriodId": string
}
字段
courseId

string

课程的标识符。

只读。
id

string

此课程作业的标识符（由 Google 课堂分配，每门课程的标识符都是唯一的）。

只读。
title

string

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

string

此课业的可选说明。如果设置，说明必须是有效的 UTF-8 字符串，且包含不超过 30,000 个字符。
materials[]

object (Material)

其他资料。

课程作业最多只能包含 20 项资料。
state

enum (CourseWorkState)

此作业的状态。如果未指定，则默认状态为 DRAFT。
creationTime

string (Timestamp format)

此课业的创建时间戳。

只读。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

此课业最近一次更改的时间戳。

只读。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
dueDate

object (Date)

此课业的提交截止日期（采用世界协调时间 [UTC]），此字段为可选字段。如果指定了 dueTime，则必须指定此参数。
dueTime

object (TimeOfDay)

此课程作业提交截止时间（可选，采用世界协调时间 [UTC]）。如果指定了 dueDate，则必须指定此参数。
scheduledTime

string (Timestamp format)

此课业计划发布的时间戳（可选）。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
maxPoints

number

此课业的最高成绩。如果为零或未指定，则此作业会被视为不评分。此值必须为非负整数值。
workType

enum (CourseWorkType)

此课程作业的类型。

类型在创建课业时设置，无法更改。
associatedWithDeveloper

boolean

此课程作业项是否与发出请求的开发者控制台项目相关联。

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

只读。
assigneeMode

enum (AssigneeMode)

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

object (IndividualStudentsOptions)

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

enum (SubmissionModificationMode)

用于确定何时允许学生修改提交内容的设置。如果未指定，则默认值为 MODIFIABLE_UNTIL_TURNED_IN。
creatorUserId

string

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

只读。
topicId

string

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

object (GradeCategory)

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

只读。
previewVersion

enum (PreviewVersion)

仅限输出。用于检索此资源的 API 的预览版本。
learningGoals[]

object (LearningGoal)

可选。

对附加到此课业的所有学习目标的引用。CourseWork 最多可以有 10 个学习目标。只有在设置了适当的 previewVersion 时，系统才会填充此字段。
特定于某种课程作业类型的其他详细信息。以下是互斥字段的列表。在响应中，最多只能设置以下字段之一：
assignment

object (Assignment)

分配任务详情。仅当 workType 为 ASSIGNMENT 时，系统才会填充此字段。

只读。
multipleChoiceQuestion

object (MultipleChoiceQuestion)

单选题详情。对于读取操作，仅当 workType 为 MULTIPLE_CHOICE_QUESTION 时，系统才会填充此字段。对于写入操作，在创建 workType 为 MULTIPLE_CHOICE_QUESTION 的课程作业时，必须指定此字段，否则不得设置此字段。
互斥字段结束。
gradingPeriodId

string

与课程作业关联的评分周期的标识符。

  • 在创建时，如果未指定，评分周期 ID 将根据 dueDate（如果未设置 dueDate，则为 scheduledTime）进行设置。
  • 如需指明不与任何评分周期关联，请将此字段设置为空字符串 ("")。
  • 如果指定，则必须与课程中现有的评分周期 ID 匹配。

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

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