REST Resource: courses.courseWork.studentSubmissions

资源:StudentSubmission

学生提交的课程作业。

创建 CourseWork 内容时,系统会生成“Student 提交内容”内容。

从未访问过的学生提交内容(即 state = NEW)可能没有创建时间或更新时间。

JSON 表示法
{
  "courseId": string,
  "courseWorkId": string,
  "id": string,
  "userId": string,
  "creationTime": string,
  "updateTime": string,
  "state": enum (SubmissionState),
  "late": boolean,
  "draftGrade": number,
  "assignedGrade": number,
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],

  // Union field content can be only one of the following:
  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
  // End of list of possible types for union field content.
}
字段
courseId

string

课程的标识符。

只读。

courseWorkId

string

与此对应的课程作业的标识符。

只读。

id

string

课堂为学生提交作业分配的标识符。这一点与相关课程作业所提交的内容不同。

只读。

userId

string

拥有此提交作业的学生的标识符。

只读。

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"

state

enum (SubmissionState)

此提交内容的状态。

只读。

late

boolean

此提交是否延迟。

只读。

draftGrade

number

(可选)待成绩。如果未设置,系统将不会设置任何成绩。此值必须是非负数。允许使用小数(即非整数)值,但会四舍五入到小数点后两位。

该名称仅供课程教师查看,也可修改。

assignedGrade

number

可选成绩。如果未设置,系统将不会设置任何成绩。此值必须是非负数。允许使用小数(即非整数)值,但会四舍五入到小数点后两位。

只有课程教师可以修改此名称。

courseWorkType

enum (CourseWorkType)

此提交内容适用的课程作业类型。

只读。

associatedWithDeveloper

boolean

学生提交的此内容是否与发出请求的 Play 管理中心项目相关联。

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

只读。

submissionHistory[]

object (SubmissionHistory)

提交内容历史记录(包括状态和成绩历史记录)。

只读。

联合字段 content。提交的内容。具体类型取决于 course_work_type 的值。content 只能是下列其中一项:
assignmentSubmission

object (AssignmentSubmission)

当 courseWorkType 为 ASSIGNMENT 时的提交内容。

学生可以使用“studentSubmissions.modifyAttachments”修改此内容。

shortAnswerSubmission

object (ShortAnswerSubmission)

当课程工作类型为 SHORT_ANSWER_QUESTION 时,所提交的内容。

multipleChoiceSubmission

object (MultipleChoiceSubmission)

当 courseWorkType 为 MULTIPLE_CHOICE_QUESTION 时,所提交的内容。

作业提交

学生完成作业。

JSON 表示法
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
字段
attachments[]

object (Attachment)

学生添加的附件。如果学生未在 Google 课堂中访问作业,则共享模式为 STUDENT_COPY 的资料可能尚不存在对应的云端硬盘文件。

只有当发出请求的用户有权访问某些附件元数据时,系统才会填充这些元数据。“Identifier”和“alternateLink”字段始终可用,但其他字段(例如“title”)可能不可用。

附件

已将附件添加到学生的作业中。

创建附件时,不支持设置 form 字段。

JSON 表示法
{

  // Union field attachment can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field attachment.
}
字段
联合字段 attachment。附件数据。attachment 只能是下列其中一项:
driveFile

object (DriveFile)

Google 云端硬盘文件附件。

youTubeVideo

object (YouTubeVideo)

YouTube 视频附件。

form

object (Form)

Google 表单附件。

ShortAnswerSubmission

学生完成简答题的作业。

JSON 表示法
{
  "answer": string
}
字段
answer

string

学生对简答题的回复。

选择提交

学生做单选题。

JSON 表示法
{
  "answer": string
}
字段
answer

string

学生选择的选项。

提交历史记录

提交内容的历史记录。目前包括州/省/自治区/直辖市和成绩历史记录。

JSON 表示法
{

  // Union field type can be only one of the following:
  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
  // End of list of possible types for union field type.
}
字段
联合字段 type。SubmissionHistory 的类型,可以是 StateHistory、GradeHistory 的类型。type 只能是下列其中一项:
stateHistory

object (StateHistory)

提交内容的状态历史记录信息(如果存在)。

gradeHistory

object (GradeHistory)

提交的作业的成绩历史记录信息(如果有)。

StateHistory

此提交内容所处的各种状态的历史记录。

JSON 表示法
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
字段
state

enum (State)

工作流流水线阶段。

stateTimestamp

string (Timestamp format)

提交内容进入此状态的时间。

时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

actorUserId

string

执行更改的教师或学生。

状态

提交内容可能所处的状态。

枚举
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 (GradeChangeType)
}
字段
pointsEarned

number

当前在提交内容成绩历史记录中的成绩分子。

maxPoints

number

当前提交作业的成绩历史记录中的成绩分母。

gradeTimestamp

string (Timestamp format)

提交作业的成绩发生更改的时间。

时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

actorUserId

string

更改成绩的教师。

gradeChangeType

enum (GradeChangeType)

当前在提交作业的成绩历史记录中,成绩更改类型。

成绩更改类型

可能的成绩变化类型。

枚举
UNKNOWN_GRADE_CHANGE_TYPE 未指定成绩更改类型。绝不应返回此值。
DRAFT_GRADE_POINTS_EARNED_CHANGE 初始成绩的分子发生更改。
ASSIGNED_GRADE_POINTS_EARNED_CHANGE 指定成绩的分子发生变化。
MAX_POINTS_CHANGE 成绩分母发生变化。

方法

get

返回学生提交的内容。

list

返回允许请求者查看的学生提交内容列表(考虑请求的 OAuth 范围)。

modifyAttachments

可以修改学生提交的作业的附件。

patch

更新学生提交的作业的一个或多个字段。

reclaim

代表拥有学生作业的学生收回学生提交的内容。

return

返回学生提交的内容。

turnIn

学生上交作业。