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

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

只读。
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 反映了当前有效的评分准则；如果教师删除并重新创建了评分准则，此 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)

当 classWorkType 为 ASSIGNMENT 时，提交内容。

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

object (ShortAnswerSubmission)

当 courseWorkType 为 SHORT_ANSWER_QUESTION 时，提交内容。
multipleChoiceSubmission

object (MultipleChoiceSubmission)

当 courseWorkType 为 MULTIPLE_CHOICE_QUESTION 时，提交内容。

RubricGrade

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

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

 上交学生提交的作业。