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

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

Google 课堂为学生提交的作业分配的标识符。在相关课程作业提交时,这是独一无二的。

只读。

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

(可选)成绩。如果未设置,则不会设置成绩。此值必须是非负数。允许使用小数(即非整数)值,但四舍五入到小数点后两位。

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

courseWorkType

enum (CourseWorkType)

此提交的课程类型。

只读。

associatedWithDeveloper

boolean

此学生提交的作业是否与发出请求的开发者控制台项目相关联。

如需了解详情,请参阅 courseWork.create

只读。

submissionHistory[]

object (SubmissionHistory)

提交的历史记录(包括状态和成绩历史记录)。

只读。

联合字段 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 时提交提交内容。

提交状态

学生提交的作业可能的状态。

枚举
SUBMISSION_STATE_UNSPECIFIED 未指定状态。切勿返回此值。
NEW 该学生从未访问过此提交内容。系统不会返回附件,也不会设置时间戳。
CREATED 已创建。
TURNED_IN 已交给教师。
RETURNED 已发回给学生。
RECLAIMED_BY_STUDENT 学生选择“取消提交”该作业。

作业提交

学生的作业。

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

object (Attachment)

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

部分附件元数据仅会在发出请求的用户有权访问时填充。“标识符”字段和“alternateLink”字段始终可用,但其他字段(例如,标题)可能无法使用。

附件

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

创建附件时,不支持设置 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 表单附件。

提交简短回复

学生回答简答题。

JSON 表示法
{
  "answer": string
}
字段
answer

string

学生对简答题的回复。

选择题

学生为选择题创建作业。

JSON 表示法
{
  "answer": string
}
字段
answer

string

学生的选择。

提交历史记录

提交的历史记录。其中包括州和成绩记录。

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)

提交的成绩历史记录信息(如果存在)。

状态记录

此提交状态对应的各个州的历史记录。

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

成绩记录

此提交作业的各个成绩记录。

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

上交学生提交的作业。