- 资源:StudentSubmission
- SubmissionState
- 作业提交
- 附件
- ShortAnswerSubmission
- 选择题提交
- SubmissionHistory
- StateHistory
- 状态
- 成绩历史记录
- 成绩更改类型
- 方法
资源:StudentSubmission
学生提交课程作业。
创建 CourseWork 内容后,会生成 StudentSubmission 项。
从未访问过的学生提交的作业(即 state
= NEW)没有创建时间或更新时间。
JSON 表示法 |
---|
{ "courseId": string, "courseWorkId": string, "id": string, "userId": string, "creationTime": string, "updateTime": string, "state": enum ( |
字段 | |
---|---|
courseId |
课程的标识符。 只读。 |
courseWorkId |
相应课程作业的标识符。 只读。 |
id |
Google 课堂为学生提交的作业分配的标识符。在相关课程作业提交时,这是独一无二的。 只读。 |
userId |
此提交内容归学生的标识符。 只读。 |
creationTime |
此提交内容的创建时间。如果学生尚未访问此内容,系统可能会取消此设置。 只读。 此时间戳采用 RFC3339 世界协调时间 (UTC)“祖鲁时”格式,纳秒精度和最多九个小数位。示例: |
updateTime |
此提交内容的上次更新时间。如果学生尚未访问此内容,系统可能会取消此设置。 只读。 此时间戳采用 RFC3339 世界协调时间 (UTC)“祖鲁时”格式,纳秒精度和最多九个小数位。示例: |
state |
此提交内容的状态。 只读。 |
late |
提交延迟。 只读。 |
draftGrade |
可选的待处理成绩。如果未设置,则不会设置成绩。此值必须是非负数。允许使用小数(即非整数)值,但四舍五入到小数点后两位。 只有课程教师可以看到和修改。 |
assignedGrade |
(可选)成绩。如果未设置,则不会设置成绩。此值必须是非负数。允许使用小数(即非整数)值,但四舍五入到小数点后两位。 只有课程教师可以修改此设置。 |
alternateLink |
Google 课堂网页界面中提交内容的绝对链接。 只读。 |
courseWorkType |
此提交的课程类型。 只读。 |
associatedWithDeveloper |
此学生提交的作业是否与发出请求的开发者控制台项目相关联。 如需了解详情,请参阅 只读。 |
submissionHistory[] |
提交的历史记录(包括状态和成绩历史记录)。 只读。 |
联合字段 content 。提交的内容。具体类型取决于 course_work_type 的值。content 只能是下列其中一项: |
|
assignmentSubmission |
courseWorkType 为 ASSIGNMENT 时提交内容。 学生可以使用“ |
shortAnswerSubmission |
courseWorkType 为 SHORT_ANSWER_QUESTION 时提交的内容。 |
multipleChoiceSubmission |
courseWorkType 为 MULTIPLE_CHOICE_QUESTION 时提交提交内容。 |
提交状态
学生提交的作业可能的状态。
枚举 | |
---|---|
SUBMISSION_STATE_UNSPECIFIED |
未指定状态。切勿返回此值。 |
NEW |
该学生从未访问过此提交内容。系统不会返回附件,也不会设置时间戳。 |
CREATED |
已创建。 |
TURNED_IN |
已交给教师。 |
RETURNED |
已发回给学生。 |
RECLAIMED_BY_STUDENT |
学生选择“取消提交”该作业。 |
作业提交
学生的作业。
JSON 表示法 |
---|
{
"attachments": [
{
object ( |
字段 | |
---|---|
attachments[] |
学生添加的附件。如果学生尚未在 Google 课堂中访问作业,则共享内容为 STUDENT_COPY 的资料所对应的云端硬盘文件可能尚不存在。 部分附件元数据仅会在发出请求的用户有权访问时填充。“标识符”字段和“alternateLink”字段始终可用,但其他字段(例如,标题)可能无法使用。 |
附件
附件已添加到学生的作业中。
创建附件时,不支持设置 form
字段。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 attachment 。附件数据。attachment 只能是下列其中一项: |
|
driveFile |
Google 云端硬盘文件的附件。 |
youTubeVideo |
YouTube 视频附件。 |
link |
链接附件。 |
form |
Google 表单附件。 |
提交简短回复
学生回答简答题。
JSON 表示法 |
---|
{ "answer": string } |
字段 | |
---|---|
answer |
学生对简答题的回复。 |
选择题
学生为选择题创建作业。
JSON 表示法 |
---|
{ "answer": string } |
字段 | |
---|---|
answer |
学生的选择。 |
提交历史记录
提交的历史记录。其中包括州和成绩记录。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 type 。SubmissionHistory 的类型,它可以是 StateHistory 和 GradeHistory 之一。type 只能是下列其中一项: |
|
stateHistory |
提交的状态历史记录信息(如果存在)。 |
gradeHistory |
提交的成绩历史记录信息(如果存在)。 |
状态记录
此提交状态对应的各个州的历史记录。
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 范围,返回允许请求者查看的学生提交的列表。 |
|
修改学生提交的附件。 |
|
更新学生提交的一个或多个字段。 |
|
代表拥有学生作业的学生收回学生提交的作业。 |
|
返回学生提交的作业。 |
|
上交学生提交的作业。 |