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

Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

REST Resource: courses.courseWork.studentSubmissions

资源：StudentSubmission

学生提交的课程作业。

StudentSubmission 项会在 CourseWork 项创建时生成。

从未访问过的学生提交内容（即 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`), "assignmentSubmission": { object (`AssignmentSubmission`) }, "shortAnswerSubmission": { object (`ShortAnswerSubmission`) }, "multipleChoiceSubmission": { object (`MultipleChoiceSubmission`) } }

{
  "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),

  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
}

字段
`courseId`	`string` 课程的标识符。只读。
`courseWorkId`	`string` 此作业对应的课程作业的标识符。只读。
`id`	`string` Google 课堂为学生提交的内容分配的标识符。这在相关课业的作业中是唯一的。只读。
`userId`	`string` 拥有此作业的学生的标识符。只读。
`creationTime`	`string (Timestamp format)` 此提交内容的创建时间。如果学生尚未访问此内容，则此字段可能未设置。只读。采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 会发生变化。只读。开发者预览版：作为 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` 此学生作业是否与发出请求的 Developer Console 项目相关联。如需了解详情，请参阅 `courseWork.create`。只读。
`submissionHistory[]`	`object (SubmissionHistory)` 提交内容的历史记录（包括状态和成绩历史记录）。只读。
`previewVersion`	`enum (PreviewVersion)` 仅限输出。API 的预览版。必须设置此属性，才能访问预览计划中向开发者提供的新 API 功能。
提交的内容。具体类型取决于 `course_work_type` 的值。以下是互斥字段的列表。在响应中，最多只能设置以下字段之一：
`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 的资料对应的云端硬盘文件可能尚不存在。只有在发出请求的用户有权访问附件元数据时，系统才会填充这些元数据。标识符和 alternateLink 字段始终可用，但其他字段（例如 title）可能不可用。

attachments[]

object (Attachment)

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

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

附件

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

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

JSON 表示法
{ "driveFile": { object (`DriveFile`) }, "youTubeVideo": { object (`YouTubeVideo`) }, "link": { object (`Link`) }, "form": { object (`Form`) } }

字段
附件数据。以下是互斥字段的列表。在响应中，最多只能设置以下字段之一：
`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 表示法
{ "stateHistory": { object (`StateHistory`) }, "gradeHistory": { object (`GradeHistory`) } }

字段
SubmissionHistory 的类型，可以是 StateHistory、GradeHistory 之一。以下是互斥字段的列表。在响应中，最多只能设置以下字段之一：
`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 规范化（即转换为 UTC 零时区格式并在末尾附加 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

enum (State)

工作流流水线阶段。

stateTimestamp

string (Timestamp format)

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

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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`	上交学生提交的内容。

REST Resource: courses.courseWork.studentSubmissions

资源：StudentSubmission

RubricGrade

AssignmentSubmission

附件

ShortAnswerSubmission

MultipleChoiceSubmission

SubmissionHistory

StateHistory

州

GradeHistory

GradeChangeType

方法

`get`

`list`

`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

REST Resource: courses.courseWork.studentSubmissions

`get`

`list`

`modifyAttachments`

`patch`

`reclaim`

`return`

`turnIn`