REST Resource: courses.courseWork.studentSubmissions

资源：学生提交内容

学生提交的课程作业。

创建 CourseWork 项时，系统会生成 StudentSubmission 项。

从未访问过（即 state = NEW）的学生提交的作业可能没有创建时间或更新时间。

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

  // 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

可选成绩。如果未设置，则未设置成绩。此值必须是非负数。允许使用十进制值（即非整数值），但会四舍五入到小数点后两位。

此设置仅可由课程教师修改。
rubricId

string

仅限输出。当前附加到本课程作业的评分准则的标识符，用于为此次学生提交的作业评分。

如果没有评分准则，则此 ID 为空。此 ID 反映的是当前有效的评分准则；如果教师删除并重新创建评分准则，则更改会发生改变。

只读。
draftRubricGrades

map (key: string, value: object (RubricGrade))

根据评分准则标准确定的待处理评分准则成绩。

如果本课程作业没有附加评分准则或附加了评分准则，但未针对任何标准设置评分，那么此地图将为空。系统只会为已设置的成绩填充条目。键：评分准则的标准 ID。

只读。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
assignedRubricGrades

map (key: string, value: object (RubricGrade))

根据评分准则的“标准”分配的评分准则成绩。

如果本课程作业没有附加评分准则，或者附加了评分准则，但未给任何标准设置评分，那么此地图将为空。系统只会为已设置的成绩填充条目。键：评分准则的标准 ID。

只读。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
courseWorkType

enum (CourseWorkType)

此提交内容所针对的课程作业类型。

只读。
associatedWithDeveloper

boolean

此学生提交的作业是否与发出请求的 Developer Console 项目相关联。

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

只读。
submissionHistory[]

object (SubmissionHistory)

提交历史记录（包括状态和成绩历史记录）。

只读。
previewVersion

enum (PreviewVersion)

仅限输出。API 的预览版本。必须设置此字段，才能使用预览版计划中向开发者提供的新的 API 功能。
联合字段 content。提交内容。具体类型取决于 course_work_type 的值。content 只能是下列其中一项：
assignmentSubmission

object (AssignmentSubmission)

CourseWorkType 为 ASSIGNMENT 时的提交内容。

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

object (ShortAnswerSubmission)

CourseWorkType 为 SHORT_ANSWER_QUESTION 时的提交内容。
multipleChoiceSubmission

object (MultipleChoiceSubmission)

CourseWorkType 为 MULTIPLE_CHOICE_QUESTION 时的提交内容。

RubricGrade

为学生提交的作业设置评分准则成绩。每个评分准则最多只能有一个条目。

JSON 表示法 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
字段
criterionId

string

可选。条件 ID。
levelId

string

可选。所选级别的可选级别 ID。如果留空，则表示未选择任何会员级别。
points

number

可选。为此评分标准分配的可选分数，通常按等级而定。不同关卡不一定包含积分。如果未设置，则不为此标准设置任何分。

AssignmentSubmission

学生完成某项作业。

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

学生对简答题的回答。

MultipleChoiceSubmission

学生回答一个选择题。

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

string

学生的选择。

SubmissionHistory

提交内容的历史记录。目前包括状态和成绩历史记录。

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 学生在上交作业后对提交的内容进行了修改。目前，仅供“问题”在学生修改答案时使用。

GradeHistory

此次提交作业的成绩历史记录。

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)

目前，提交成绩历史记录中的成绩类型变化。

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

 上交学生提交的作业。