REST Resource: courses.courseWork

资源：CourseWork
- JSON 表示法
CourseWorkState
SubmissionModificationMode
作业
- JSON 表示法
MultipleChoiceQuestion
- JSON 表示法
方法

资源：CourseWork

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

JSON 表示法

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`), // 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`. "gradingPeriodId": string }

{
  "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),

  // 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.
  "gradingPeriodId": string
}

字段
`courseId`	`string` 课程的标识符。只读。
`id`	`string` Google 课堂为此作业分配的标识符，每个课程的标识符都不相同。只读。
`title`	`string` 此课程作业的标题。标题必须是有效的 UTF-8 字符串，长度介于 1 到 3,000 个字符之间。
`description`	`string` 此课程工作的可选说明。如果设置，说明必须是有效的 UTF-8 字符串，且不得超过 3 万个字符。
`materials[]`	`object (Material)` 其他资料。课业不得超过 20 项材料。
`state`	`enum (CourseWorkState)` 此课程作业的状态。如果未指定，则默认状态为 `DRAFT`。
`alternateLink`	`string` 指向 Google 课堂网页界面中此课业作业的绝对链接。仅当 `state` 为 `PUBLISHED` 时才会填充此字段。只读。
`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)` 此课程作业的截止日期（可选，采用世界协调时间 [UTC]）。如果指定了 `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)` 有权访问课程的学生的标识符。只有当 `assigneeMode` 为 `INDIVIDUAL_STUDENTS` 时，系统才会设置此字段。如果 `assigneeMode` 为 `INDIVIDUAL_STUDENTS`，则只有此字段中指定的学生会被分配课程。
`submissionModificationMode`	`enum (SubmissionModificationMode)` 用于确定学生何时可以修改提交内容的设置。如果未指定，则默认值为 `MODIFIABLE_UNTIL_TURNED_IN`。
`creatorUserId`	`string` 创建课程的用户的标识符。只读。
`topicId`	`string` 与此课程相关联的主题的标识符。必须与课程中现有的主题一致。
`gradeCategory`	`object (GradeCategory)` 此课程成绩对应的类别。仅当为课程选择了类别时才会显示。可用于计算总体成绩。只读。
`previewVersion`	`enum (PreviewVersion)` 仅限输出。用于检索此资源的 API 的预览版。
联合字段 `details`。特定于某种类型的课业作业的其他详细信息。`details` 只能是下列其中一项：
`assignment`	`object (Assignment)` 作业详情。仅当 `workType` 为 `ASSIGNMENT` 时才会填充此字段。只读。
`multipleChoiceQuestion`	`object (MultipleChoiceQuestion)` 单选题详细信息。对于读取操作，只有当 `workType` 为 `MULTIPLE_CHOICE_QUESTION` 时，系统才会填充此字段。对于写入操作，在创建 `workType` 为 `MULTIPLE_CHOICE_QUESTION` 的课业时，必须指定此字段，否则不得设置此字段。
`gradingPeriodId`	`string` 与课程相关联的评分周期的标识符。如果未指定，系统会根据 `dueDate`（如果未设置 `dueDate`，则为 `scheduledTime`）设置评分周期 ID。如需指明与任何评分周期都没有关联，请将此字段设置为空字符串（“”）。如果指定，则必须与课程中现有的评分周期 ID 一致。开发者预览版：通过 Google Workspace 开发者预览版计划提供，可抢先体验某些功能。此功能适用于 `V1_20240401_PREVIEW` 及更高版本。如需了解详情，请参阅访问预览版 API。

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)` 存放学生提交的附件的云端硬盘文件夹。只有课程教师和管理员才能填写此字段。

studentWorkFolder

object (DriveFolder)

存放学生提交的附件的云端硬盘文件夹。只有课程教师和管理员才能填写此字段。

MultipleChoiceQuestion

有关单选题的更多详细信息。

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

字段

字段
`choices[]`	`string` 可能的选择。

choices[]

string

可能的选择。

方法
`create`	创建课程作业。
`delete`	删除课业。
`get`	返回课程作业。
`getAddOnContext`	在特定帖子的上下文中获取 Google 课堂插件元数据。
`list`	返回请求者有权查看的课业列表。
`modifyAssignees`	修改课程的分配者模式和选项。
`patch`	更新课程作业的一个或多个字段。

REST Resource: courses.courseWork

资源：CourseWork

CourseWorkState

SubmissionModificationMode

作业

MultipleChoiceQuestion

方法

`create`

`delete`

`get`

`getAddOnContext`

`list`

`modifyAssignees`

`patch`