REST Resource: courses.courseWork.studentSubmissions

资源：StudentSubmission

学生提交的课程作业。

创建 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

Google 课堂为学生提交内容分配的标识符。此 ID 在相关课程作业的提交内容中是唯一的。

只读。
userId

string

拥有此提交内容的学生的标识符。

只读。
creationTime

string (Timestamp format)

此提交内容的创建时间。如果学生尚未访问此内容，则此属性可能未设置。

只读。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

此提交内容的上次更新时间。如果学生尚未访问此内容，则此属性可能未设置。

只读。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
state

enum (SubmissionState)

此提交内容的状态。

只读。
late

boolean

此提交内容是否迟交。

只读。
draftGrade

number

可选的待评分。如果未设置，则表示未设置任何成绩。此值必须为非负值。允许使用小数（即非整数）值，但会四舍五入为两位小数。

只有课程教师才能看到和修改此信息。
assignedGrade

number

可选的成绩。如果未设置，则表示未设置任何成绩。此值必须为非负值。允许使用小数（即非整数）值，但会四舍五入为两位小数。

只有课程教师可以修改此设置。
rubricId

string

仅限输出。目前附加在此课业作业中并用于评分此学生提交内容的评分标准的标识符。

如果没有评分标准，此 ID 为空。此 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

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

如需了解详情，请参阅 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)

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

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
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)

提交内容的成绩更改的时间。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
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

 提交学生提交的内容。