- 资源:StudentSubmission
- RubricGrade
- AssignmentSubmission
- 附件
- ShortAnswerSubmission
- MultipleChoiceSubmission
- SubmissionHistory
- StateHistory
- 状态
- GradeHistory
- GradeChangeType
- 方法
资源:StudentSubmission
学生提交的课程作业。
创建 CourseWork
项时,系统会生成 StudentSubmission
项。
从未访问过数据(即,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 |
可选成绩。如果未设置,则表示未设置任何成绩。此值必须是非负数。允许使用小数(即非整数)值,但会四舍五入到小数点后两位。 只有课程教师可以修改此名称。 |
rubricId |
仅供输出。当前附加到此课程作业的评分准则的标识符,用于为此学生提交的作业评分。 如果没有评分准则,则此 ID 为空。此 ID 反映了当前有效的评分准则;如果教师删除并重新创建了评分准则,此 ID 会发生变化。 只读。 |
draftRubricGrades |
根据评分准则确定的待定评分准则。 如果本课程作业没有附加评分准则,或者附加了评分准则,但没有针对任何评分标准设置成绩,则此地图为空。系统只会为已设置的成绩填充条目。键:评分准则的标准 ID。 只读。 包含一系列 |
assignedRubricGrades |
根据评分准则的评定标准为其分配的评分。 如果本课程作业没有附加评分准则,或者附加了评分准则,但没有针对任何条件设置成绩,则此地图为空。系统只会为已设置的成绩填充条目。键:评分准则的标准 ID。 只读。 包含一系列 |
alternateLink |
指向 Google 课堂网页界面中提交的作业的绝对链接。 只读。 |
courseWorkType |
此提交的课程作业的类型。 只读。 |
associatedWithDeveloper |
学生提交的此内容是否与发出请求的 Play 管理中心项目相关联。 如需了解详情,请参阅 只读。 |
submissionHistory[] |
提交的历史记录(包括状态和成绩历史记录)。 只读。 |
previewVersion |
仅供输出。API 的预览版本。必须设置此字段,才能使用预览版计划中为开发者提供的新 API 功能。 |
联合字段 content 。提交内容。具体类型取决于 course_work_type 的值。content 只能是下列其中一项: |
|
assignmentSubmission |
当 classWorkType 为 ASSIGNMENT 时,提交内容。 学生可以使用“ |
shortAnswerSubmission |
当 courseWorkType 为 SHORT_ANSWER_QUESTION 时,提交内容。 |
multipleChoiceSubmission |
当 courseWorkType 为 MULTIPLE_CHOICE_QUESTION 时,提交内容。 |
RubricGrade
为学生提交的作业设置评分准则成绩。每个评分准则最多只能有 1 个条目。
JSON 表示法 |
---|
{ "criterionId": string, "levelId": string, "points": number } |
字段 | |
---|---|
criterionId |
可选。条件 ID。 |
levelId |
可选。所选层级的可选层级 ID。如果为空,则表示未选择任何级别。 |
points |
可选。为此标准分配的可选积分,通常根据等级而定。等级不一定包含积分。如果未设置,则不会为此标准设置分值。 |
AssignmentSubmission
学生完成作业。
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 |
学生对简答题的回复。 |
MultipleChoiceSubmission
学生完成选择题。
JSON 表示法 |
---|
{ "answer": string } |
字段 | |
---|---|
answer |
学生选择的选项。 |
SubmissionHistory
提交内容历史记录。目前包括状态和成绩历史记录。
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 |
学生上交后修改了提交的作业。目前,仅在学生修改自己的回答时供“问题”使用。 |
GradeHistory
此次提交中各个成绩的历史记录。
JSON 表示法 |
---|
{
"pointsEarned": number,
"maxPoints": number,
"gradeTimestamp": string,
"actorUserId": string,
"gradeChangeType": enum ( |
字段 | |
---|---|
pointsEarned |
当前成绩在提交内容成绩历史记录中的分子。 |
maxPoints |
当前成绩在提交成绩历史记录中的分母。 |
gradeTimestamp |
提交内容成绩发生更改的时间。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例: |
actorUserId |
更改成绩的教师。 |
gradeChangeType |
目前,提交的成绩历史记录中的成绩类型发生变化。 |
GradeChangeType
可能的成绩更改类型。
枚举 | |
---|---|
UNKNOWN_GRADE_CHANGE_TYPE |
未指定成绩更改类型。绝不应返回此值。 |
DRAFT_GRADE_POINTS_EARNED_CHANGE |
初始成绩的分子发生变化。 |
ASSIGNED_GRADE_POINTS_EARNED_CHANGE |
指定成绩的分子发生变化。 |
MAX_POINTS_CHANGE |
成绩的分母发生变化。 |
方法 |
|
---|---|
|
返回学生提交的作业。 |
|
返回允许请求者查看的学生提交的作业列表(需考虑请求的 OAuth 范围)。 |
|
修改学生提交的作业附件。 |
|
更新学生提交的作业的一个或多个字段。 |
|
请代表学生收回学生提交的作业。 |
|
返回学生提交的作业。 |
|
上交学生提交的作业。 |