您的用户是通过 Google Meet 使用 Google 课堂吗?请查看 Apps 脚本快速入门 - 了解如何在 Google Meet 课程中查看学生出席情况

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

此课程作业由 Google 课堂分配的标识符,每个课程具有唯一性。

只读。

title

string

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

description

string

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

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)

(可选)课程作业提交截止时间(世界协调时间)。如果指定了 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

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

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

只读。

assigneeMode

enum (AssigneeMode)

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

individualStudentsOptions

object (IndividualStudentsOptions)

可访问课程作业的学生标识符。仅当 assigneeModeINDIVIDUAL_STUDENTS 时,此字段才设置。如果 assigneeModeINDIVIDUAL_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 时填充此字段。对于写入操作,使用 workTypeMULTIPLE_CHOICE_QUESTION 的课程作业创建时必须指定此字段,否则不得设置。

课程作业状态

课程作业可能的状态。

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

日期

表示整个或部分日历日期,例如生日。时段和时区要么在其他地方指定,要么没什么意义。该日期相对于公历。它可以表示以下某种状态:

  • 包含非零年、月和日值的完整日期。
  • 月份和日,零年(例如周年纪念日)。
  • 一年零日,零零月零日。
  • 年和月,日期为零(例如信用卡失效日期)。

相关类型:

JSON 表示法
{
  "year": integer,
  "month": integer,
  "day": integer
}
字段
year

integer

日期。必须介于 1 到 9999 之间,或为 0 才能指定不带年份的日期。

month

integer

一年中的月。必须为 1 到 12 或 0,用于指定不带月和日的年份。

day

integer

一个月中的第几天。必须是 1 到 31 并且对年和月有效,如果值为 0,则表示仅指定年份,也可以指定年份和月份,但不指定日期。

TimeOfDay

表示一天中的某个时间。日期和时区不重要,或在别处指定。API 可以选择允许闰秒。相关类型为 google.type.Dategoogle.protobuf.Timestamp

JSON 表示法
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
字段
hours

integer

一天中的小时(采用 24 小时制)。值应为 0 到 23。对于业务结束时间等场景,API 可以选择允许“24:00:00”一值。

minutes

integer

一天中某小时的分钟数。值必须是介于 0 和 59 之间的数字。

seconds

integer

时间的秒数部分。通常必须是介于 0 和 59 之间的数字。如果 API 允许闰秒,则 API 可以允许 60 一值。

nanos

integer

秒数的小数部分(以纳秒为单位)。值必须是介于 0 和 999999999 之间的数字。

提交修改模式

可能适用于学生提交的修改模式。

枚举
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED 未指定修改模式。永远不会返回。
MODIFIABLE_UNTIL_TURNED_IN 上交的作业可在上交前进行修改。
MODIFIABLE 您可以随时修改参评材料。

作业

作业的其他详细信息。

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

object (DriveFolder)

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

选择题

选择题的其他详细信息。

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

string

可能的选项。

方法

create

创建课程作业。

delete

删除课程作业。

get

返回课程作业。

list

返回请求者可以查看的课程作业列表。

modifyAssignees

修改作业模式和课程作业选项。

patch

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