您的用户是通过 Google Meet 使用 Google 课堂吗？请查看 Apps 脚本快速入门 - 了解如何在 Google Meet 课程中查看学生出席情况。

此页面由 Cloud Translation API 翻译。

Switch to English

REST Resource: courses.courseWork.studentSubmissions

资源：StudentSubmission
- JSON 表示法
AssignmentSubmission
- JSON 表示法
附件
- JSON 表示法
ShortAnswerSubmission
- JSON 表示法
MultipleChoiceSubmission（多选项提交）
- JSON 表示法
SubmissionHistory
- JSON 表示法
StateHistory
- JSON 表示法
状态
GradeHistory
- JSON 表示法
成绩更改类型
方法

资源：StudentSubmission

学生提交的课程作业。

创建 CourseWork 内容时，系统会生成“Student 提交内容”内容。

从未访问过的学生提交内容（即 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, "alternateLink": string, "courseWorkType": enum (`CourseWorkType`), "associatedWithDeveloper": boolean, "submissionHistory": [ { object (`SubmissionHistory`) } ], // 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,
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],

  // 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` 可选成绩。如果未设置，系统将不会设置任何成绩。此值必须是非负数。允许使用小数（即非整数）值，但会四舍五入到小数点后两位。只有课程教师可以修改此名称。
`alternateLink`	`string` 指向 Google 课堂网页界面中提交作业的绝对链接。只读。
`courseWorkType`	`enum (CourseWorkType)` 此提交内容适用的课程作业类型。只读。
`associatedWithDeveloper`	`boolean` 学生提交的此内容是否与发出请求的 Play 管理中心项目相关联。如需了解详情，请参阅 `courseWork.create`。只读。
`submissionHistory[]`	`object (SubmissionHistory)` 提交内容历史记录（包括状态和成绩历史记录）。只读。
联合字段 `content`。提交的内容。具体类型取决于 `course_work_type` 的值。`content` 只能是下列其中一项：
`assignmentSubmission`	`object (AssignmentSubmission)` 当 courseWorkType 为 ASSIGNMENT 时的提交内容。学生可以使用“`studentSubmissions.modifyAttachments`”修改此内容。
`shortAnswerSubmission`	`object (ShortAnswerSubmission)` 当课程工作类型为 SHORT_ANSWER_QUESTION 时，所提交的内容。
`multipleChoiceSubmission`	`object (MultipleChoiceSubmission)` 当 courseWorkType 为 MULTIPLE_CHOICE_QUESTION 时，所提交的内容。

作业提交

学生完成作业。

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

学生对简答题的回复。

选择提交

学生做单选题。

JSON 表示法
{ "answer": string }

字段

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

answer

string

学生选择的选项。

提交历史记录

提交内容的历史记录。目前包括州/省/自治区/直辖市和成绩历史记录。

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

成绩历史记录

此次提交的所有成绩的历史记录。

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)` 当前在提交作业的成绩历史记录中，成绩更改类型。

成绩更改类型

可能的成绩变化类型。

枚举
`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

作业提交

附件

ShortAnswerSubmission

选择提交

提交历史记录

StateHistory

状态

成绩历史记录

成绩更改类型

方法

`get`

`list`

`modifyAttachments`

`patch`

`reclaim`

`return`

`turnIn`