- 资源:StudentSubmission
- AssignmentSubmission
- 附件
- ShortAnswerSubmission
- MultipleChoiceSubmission(多选项提交)
- SubmissionHistory
- StateHistory
- 状态
- GradeHistory
- 成绩更改类型
- 方法
资源:StudentSubmission
学生提交的课程作业。
创建 CourseWork 内容时,系统会生成“Student 提交内容”内容。
从未访问过的学生提交内容(即 state
= NEW)可能没有创建时间或更新时间。
JSON 表示法 |
---|
{ "courseId": string, "courseWorkId": string, "id": string, "userId": string, "creationTime": string, "updateTime": string, "state": enum ( |
字段 | |
---|---|
courseId |
课程的标识符。 只读。 |
courseWorkId |
与此对应的课程作业的标识符。 只读。 |
id |
课堂为学生提交作业分配的标识符。这一点与相关课程作业所提交的内容不同。 只读。 |
userId |
拥有此提交作业的学生的标识符。 只读。 |
creationTime |
此提交内容的创建时间。如果学生未访问此内容,则可以取消设置。 只读。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例: |
updateTime |
此提交内容的上次更新时间。如果学生未访问此内容,则可以取消设置。 只读。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例: |
state |
此提交内容的状态。 只读。 |
late |
此提交是否延迟。 只读。 |
draftGrade |
(可选)待成绩。如果未设置,系统将不会设置任何成绩。此值必须是非负数。允许使用小数(即非整数)值,但会四舍五入到小数点后两位。 该名称仅供课程教师查看,也可修改。 |
assignedGrade |
可选成绩。如果未设置,系统将不会设置任何成绩。此值必须是非负数。允许使用小数(即非整数)值,但会四舍五入到小数点后两位。 只有课程教师可以修改此名称。 |
alternateLink |
指向 Google 课堂网页界面中提交作业的绝对链接。 只读。 |
courseWorkType |
此提交内容适用的课程作业类型。 只读。 |
associatedWithDeveloper |
学生提交的此内容是否与发出请求的 Play 管理中心项目相关联。 如需了解详情,请参阅 只读。 |
submissionHistory[] |
提交内容历史记录(包括状态和成绩历史记录)。 只读。 |
联合字段 content 。提交的内容。具体类型取决于 course_work_type 的值。content 只能是下列其中一项: |
|
assignmentSubmission |
当 courseWorkType 为 ASSIGNMENT 时的提交内容。 学生可以使用“ |
shortAnswerSubmission |
当课程工作类型为 SHORT_ANSWER_QUESTION 时,所提交的内容。 |
multipleChoiceSubmission |
当 courseWorkType 为 MULTIPLE_CHOICE_QUESTION 时,所提交的内容。 |
作业提交
学生完成作业。
JSON 表示法 |
---|
{
"attachments": [
{
object ( |
字段 | |
---|---|
attachments[] |
学生添加的附件。如果学生未在 Google 课堂中访问作业,则共享模式为 STUDENT_COPY 的资料可能尚不存在对应的云端硬盘文件。 只有当发出请求的用户有权访问某些附件元数据时,系统才会填充这些元数据。“Identifier”和“alternateLink”字段始终可用,但其他字段(例如“title”)可能不可用。 |
附件
已将附件添加到学生的作业中。
创建附件时,不支持设置 form
字段。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 attachment 。附件数据。attachment 只能是下列其中一项: |
|
driveFile |
Google 云端硬盘文件附件。 |
youTubeVideo |
YouTube 视频附件。 |
link |
链接附件。 |
form |
Google 表单附件。 |
ShortAnswerSubmission
学生完成简答题的作业。
JSON 表示法 |
---|
{ "answer": string } |
字段 | |
---|---|
answer |
学生对简答题的回复。 |
选择提交
学生做单选题。
JSON 表示法 |
---|
{ "answer": string } |
字段 | |
---|---|
answer |
学生选择的选项。 |
提交历史记录
提交内容的历史记录。目前包括州/省/自治区/直辖市和成绩历史记录。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 type 。SubmissionHistory 的类型,可以是 StateHistory、GradeHistory 的类型。type 只能是下列其中一项: |
|
stateHistory |
提交内容的状态历史记录信息(如果存在)。 |
gradeHistory |
提交的作业的成绩历史记录信息(如果有)。 |
StateHistory
此提交内容所处的各种状态的历史记录。
JSON 表示法 |
---|
{
"state": enum ( |
字段 | |
---|---|
state |
工作流流水线阶段。 |
stateTimestamp |
提交内容进入此状态的时间。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例: |
actorUserId |
执行更改的教师或学生。 |
状态
提交内容可能所处的状态。
枚举 | |
---|---|
STATE_UNSPECIFIED |
未指定任何州。绝不应返回此值。 |
CREATED |
提交内容已创建。 |
TURNED_IN |
学生上交了布置的作业,该文档可能不是模板。 |
RETURNED |
教师已将布置给学生的文档发回。 |
RECLAIMED_BY_STUDENT |
学生上交了布置的作业,然后选择“取消提交”该作业,再次授予学生作为所有者的控制权。 |
STUDENT_EDITED_AFTER_TURN_IN |
学生在上交作业后修改了提交的内容。目前,仅供“问题”在学生修改回答时使用。 |
成绩历史记录
此次提交的所有成绩的历史记录。
JSON 表示法 |
---|
{
"pointsEarned": number,
"maxPoints": number,
"gradeTimestamp": string,
"actorUserId": string,
"gradeChangeType": enum ( |
字段 | |
---|---|
pointsEarned |
当前在提交内容成绩历史记录中的成绩分子。 |
maxPoints |
当前提交作业的成绩历史记录中的成绩分母。 |
gradeTimestamp |
提交作业的成绩发生更改的时间。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例: |
actorUserId |
更改成绩的教师。 |
gradeChangeType |
当前在提交作业的成绩历史记录中,成绩更改类型。 |
成绩更改类型
可能的成绩变化类型。
枚举 | |
---|---|
UNKNOWN_GRADE_CHANGE_TYPE |
未指定成绩更改类型。绝不应返回此值。 |
DRAFT_GRADE_POINTS_EARNED_CHANGE |
初始成绩的分子发生更改。 |
ASSIGNED_GRADE_POINTS_EARNED_CHANGE |
指定成绩的分子发生变化。 |
MAX_POINTS_CHANGE |
成绩分母发生变化。 |
方法 |
|
---|---|
|
返回学生提交的内容。 |
|
返回允许请求者查看的学生提交内容列表(考虑请求的 OAuth 范围)。 |
|
可以修改学生提交的作业的附件。 |
|
更新学生提交的作业的一个或多个字段。 |
|
代表拥有学生作业的学生收回学生提交的内容。 |
|
返回学生提交的内容。 |
|
学生上交作业。 |