资源:CourseWork
教师为课程学生创建的课程作业。
JSON 表示法 |
---|
{ "courseId": string, "id": string, "title": string, "description": string, "materials": [ { object ( |
字段 | |
---|---|
courseId |
课程的标识符。 只读。 |
id |
此课程作业由 Google 课堂分配的标识符,每个课程具有唯一性。 只读。 |
title |
本课程作业的标题。标题必须是有效的 UTF-8 字符串(长度介于 1 到 3000 个字符之间)。 |
description |
本课程工作的可选说明。如果设置,说明必须是有效的 UTF-8 字符串,长度不超过 30,000 个字符。 |
materials[] |
其他资料。 CourseWork 中的内容资料数量不得超过 20 个。 |
state |
本课程作业的状态。如果未指定该属性,则默认状态为 |
alternateLink |
此课程的绝对链接适用于 Google 课堂网页界面。仅当 只读。 |
creationTime |
创建课程作业时的时间戳。 只读。 时间戳采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例: |
updateTime |
最近一次对本课程内容的更改的时间戳。 只读。 时间戳采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例: |
dueDate |
可选日期,采用世界协调时间,采用此课程作业提交期限。如果指定了 |
dueTime |
(可选)课程作业提交截止时间(世界协调时间)。如果指定了 |
scheduledTime |
计划发布课程作业时的可选时间戳。 时间戳采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例: |
maxPoints |
本课程作业的最高成绩。如果零或未指定,则该作业将被视为不计分。此值必须是非负整数值。 |
workType |
本课程作业的类型。 类型是在创建课程作业时设置的,无法更改。 |
associatedWithDeveloper |
课程作业项是否与发出请求的开发者控制台项目相关联。 如需了解详情,请参阅 只读。 |
assigneeMode |
课程作业的分配者模式。如果未指定值,默认值为 |
individualStudentsOptions |
可访问课程作业的学生标识符。仅当 |
submissionModificationMode |
此设置用于确定何时可以修改学生提交的内容。如果未指定值,默认值为 |
creatorUserId |
创建课程的用户的标识符。 只读。 |
topicId |
课程作业相关主题的标识符。必须与课程中的现有主题一致。 |
gradeCategory |
此课程作业的成绩对应的类别。仅当为课程类别选择类别时才会显示。可用于计算总体成绩。 只读。 |
联合字段 details 。特定于一门课程作业的其他详细信息。details 只能是下列其中一项: |
|
assignment |
作业详情。仅当 只读。 |
multipleChoiceQuestion |
选择题详细信息。对于读取操作,仅在 |
课程作业状态
课程作业可能的状态。
枚举 | |
---|---|
COURSE_WORK_STATE_UNSPECIFIED |
未指定状态。永远不会返回。 |
PUBLISHED |
已发布作品的状态。这是默认状态。 |
DRAFT |
尚未发布的作业的状态。只有课程教师和网域管理员才能看到此状态的作业。 |
DELETED |
已发布但现已删除的工作的状态。只有课程教师和网域管理员才能看到此状态的作业。处于此状态的工作会在一段时间后被删除。 |
日期
表示整个或部分日历日期,例如生日。时段和时区要么在其他地方指定,要么没什么意义。该日期相对于公历。它可以表示以下某种状态:
- 包含非零年、月和日值的完整日期。
- 月份和日,零年(例如周年纪念日)。
- 一年零日,零零月零日。
- 年和月,日期为零(例如信用卡失效日期)。
相关类型:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON 表示法 |
---|
{ "year": integer, "month": integer, "day": integer } |
字段 | |
---|---|
year |
日期。必须介于 1 到 9999 之间,或为 0 才能指定不带年份的日期。 |
month |
一年中的月。必须为 1 到 12 或 0,用于指定不带月和日的年份。 |
day |
一个月中的第几天。必须是 1 到 31 并且对年和月有效,如果值为 0,则表示仅指定年份,也可以指定年份和月份,但不指定日期。 |
TimeOfDay
表示一天中的某个时间。日期和时区不重要,或在别处指定。API 可以选择允许闰秒。相关类型为 google.type.Date
和 google.protobuf.Timestamp
。
JSON 表示法 |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
字段 | |
---|---|
hours |
一天中的小时(采用 24 小时制)。值应为 0 到 23。对于业务结束时间等场景,API 可以选择允许“24:00:00”一值。 |
minutes |
一天中某小时的分钟数。值必须是介于 0 和 59 之间的数字。 |
seconds |
时间的秒数部分。通常必须是介于 0 和 59 之间的数字。如果 API 允许闰秒,则 API 可以允许 60 一值。 |
nanos |
秒数的小数部分(以纳秒为单位)。值必须是介于 0 和 999999999 之间的数字。 |
提交修改模式
可能适用于学生提交的修改模式。
枚举 | |
---|---|
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED |
未指定修改模式。永远不会返回。 |
MODIFIABLE_UNTIL_TURNED_IN |
上交的作业可在上交前进行修改。 |
MODIFIABLE |
您可以随时修改参评材料。 |
作业
作业的其他详细信息。
JSON 表示法 |
---|
{
"studentWorkFolder": {
object ( |
字段 | |
---|---|
studentWorkFolder |
存放学生提交的附件的云端硬盘文件夹。只有课程教师和管理员填充此字段。 |
选择题
选择题的其他详细信息。
JSON 表示法 |
---|
{ "choices": [ string ] } |
字段 | |
---|---|
choices[] |
可能的选项。 |
方法 |
|
---|---|
|
创建课程作业。 |
|
删除课程作业。 |
|
返回课程作业。 |
|
返回请求者可以查看的课程作业列表。 |
|
修改作业模式和课程作业选项。 |
|
更新课程作业的一个或多个字段。 |