Google 课堂插件现已面向开发者正式推出！如需了解详情，请参阅插件文档。

此页面由 Cloud Translation API 翻译。

REST Resource: courses.courseWork.studentSubmissions

资源：StudentSubmission

学生提交的课程作业。

创建 CourseWork 项时会生成 StudentSubmission 项。

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

JSON 表示法

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,
  "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)` 此提交内容的创建时间。如果学生尚未访问此内容，则此属性可能未设置。只读。时间戳采用 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 也会随之更改。只读。开发者预览版：通过 Google Workspace 开发者预览版计划提供，可抢先体验某些功能。此功能适用于 `V1_20231110_PREVIEW` 及更高版本。如需了解详情，请参阅访问预览版 API。
`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" }`。
`alternateLink`	`string` 指向 Google 课堂网页界面中相应提交内容的绝对链接。只读。
`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` 可选。为此标准分配的可选分数，通常基于等级。等级不一定有积分。如果未设置，则表示未为此条件设置任何分数。

criterionId

string

可选。条件 ID。

levelId

string

可选。所选级别的可选级别 ID。如果为空，则表示未选择任何等级。

points

number

可选。为此标准分配的可选分数，通常基于等级。等级不一定有积分。如果未设置，则表示未为此条件设置任何分数。

AssignmentSubmission

学生的作业。

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

字段

字段
`attachments[]`	`object (Attachment)` 学生添加的附件。如果学生尚未在 Google 课堂中访问作业，则与共享模式为 STUDENT_COPY 的资料对应的云端硬盘文件可能尚不存在。只有当请求访问的用户有权访问某些附件元数据时，系统才会填充这些元数据。identifier 和 alternateLink 字段始终可用，但其他字段（例如 title）可能不可用。

attachments[]

object (Attachment)

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

只有当请求访问的用户有权访问某些附件元数据时，系统才会填充这些元数据。identifier 和 alternateLink 字段始终可用，但其他字段（例如 title）可能不可用。

附件

向学生作业中添加了附件。

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

JSON 表示法

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`. }

{

  // 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 视频附件。
`link`	`object (Link)` 链接附件。
`form`	`object (Form)` Google 表单附件。

ShortAnswerSubmission

学生对简答题的回答。

JSON 表示法
{ "answer": string }

字段

字段
`answer`	`string` 学生对简答题的回答。

answer

string

学生对简答题的回答。

MultipleChoiceSubmission

学生对多选题的答案。

JSON 表示法
{ "answer": string }

字段

字段
`answer`	`string` 学生的选择。

answer

string

学生的选择。

SubmissionHistory

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

JSON 表示法

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`. }

{

  // 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)` 提交内容的成绩历史记录信息（如果有）。

联合字段 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

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`	提交学生提交的内容。

REST Resource: courses.courseWork.studentSubmissions

资源：StudentSubmission

RubricGrade

AssignmentSubmission

附件

ShortAnswerSubmission

MultipleChoiceSubmission

SubmissionHistory

StateHistory

州

GradeHistory

GradeChangeType

方法

`get`

`list`

`modifyAttachments`

`patch`

`reclaim`

`return`

`turnIn`