成绩

本文档介绍了与 Classroom API 相关的评分概念。

如需了解 Google 课堂应用中的教师评分流程,请参阅查看成绩和跟踪作业一文。

CourseWork 和 StudentSubmissions

在 Google 课堂中,学生可以上交 CourseCourseWork 作业的 StudentSubmissionsCourseWork 可以是计分作业,也可以是不计分作业。如果作业有评分,则会有一个 CourseWork 值,表示该作业的总分。maxPoints如果 maxPoints 为零或未指定,则作业不计分。

对于评分作业,教师会在将作业发回给学生之前,在 StudentSubmission 上设置 draftGrade 成绩。当提交内容在 Google 课堂应用中返回时,系统会自动在 StudentSubmission 上设置一个 assignedGrade,其值与当前的 draftGrade 相同。开发者可以设置这两个字段,但必须模拟 Google 课堂应用的行为。例如,不能在未设置 draftGrade 的情况下设置 assignedGrade。这两个字段均以小数表示,如果未设置,则表示教师尚未设置相应的成绩。如需查看有关读取、设置和返回成绩的代码示例,请参阅创建和管理成绩

学生可以针对同一CourseWork作业提交多次作业,并且系统会在 StudentSubmission.submissionHistory 中跟踪作业提交状态和成绩记录。

迟交、已获准免交和未交的作业

分配 CourseWork 项后,系统会为每位学生创建占位符 StudentSubmissions,即使学生尚未与相应作业互动也是如此。教师可以在 CourseWork 上设置 dueDate,如果学生未在指定日期之前提交作业,则相关 StudentSubmissions 会标记为 late 字段(设置为 true)。教师还可以通过 Google 课堂应用中的设置禁止学生迟交作业

此外,在 dueDate 之前未提交的 StudentSubmissions 会在 Google 课堂成绩册中标记为缺交。教师还可以在 Google 课堂应用中手动将提交的作业标记为缺交。缺交的作业会自动获得 draftGrade 分,教师可以自定义该分数,但默认值为 0。

教师可以将缺交的作业标记为已完成免除StudentSubmissions 标记为完成的作业的默认 draftGrade 字段会被移除,直到教师手动设置新字段为止。StudentSubmissions 标记为“免除”的作业会从总体得分计算中移除,包括评分周期

如需详细了解教师如何处理提交的内容,请参阅为作业评分并退回作业帮助文章。

总体成绩和评分系统

Google 课堂支持多种评分系统,用于计算学生在课程中的总成绩。总体成绩可以直接根据总分或按类别加权计算,也可以完全不计算。

如需了解不同的评分系统,请参阅设置评分一文,其中包含示例。

以下是一些要点:

  • Course 资源具有 gradebookSettings 对象,其中包含有关课程成绩设置的详细信息。
    • calculationType 指定课程的计算方法。
    • displaySettings 用于指定谁可以在 Google 课堂应用中查看总成绩。在您自己的应用中,最好尽可能遵循此设置。例如,如果学生无法在 Google 课堂中查看总体成绩,请勿在您的应用中向他们显示总体成绩。
    • gradeCategories 包含为课程配置的评分类别列表,包括其显示名称、权重百分比和相应作业的默认分数。
  • 如果课程采用加权评分,您可能需要在没有类别的情况下对权重进行归一化处理。例如,如果家庭作业、练习题和测验的类别权重分别为 20%、10% 和 70%,但实际上没有练习题,则 Google 课堂在计算总成绩时会将权重调整为:家庭作业约占 22%,测验约占 78%。如果您打算在应用中镜像显示 Google 课堂的总成绩,则需要执行相同的操作。

评分周期

教师可以将课程中的CourseWork作业分组为不同的日期范围,称为评分周期。评分周期可用于过滤成绩册视图中的课程作业,并为总体成绩计算创建不同的分组。

例如,教师可以创建“春季”和“秋季”学期成绩评定周期。春季的总体成绩分数仅包含春季日期范围内的StudentSubmissions

为课程设置的评分系统会沿用到评分周期。因此,如果上述春季和秋季示例评分周期是针对使用加权评分类别的课程设置的,那么学生最终会有三组总体成绩:

  • 课程中所有作业的总体成绩。
  • 春季日期范围内所有作业的总成绩。
  • 秋季日期范围内所有作业的总成绩。

这三种方式都会使用加权类别来计算总体成绩。

如需大致了解此功能,请参阅成绩评定周期公告

评分周期通过 gradingPeriodId 扩展 CourseWork,用于标识作业所属的评分周期。

如需了解如何使用 API 读取和管理评分周期,请参阅评分周期 API 指南

评分准则

教师可以创建 Rubrics 并将其与 CourseWork 作业相关联,并在为相应的 StudentSubmissions 评分时使用这些评分准则作为指南。

如需了解教师如何在 Google 课堂中使用评分标准,请参阅评分标准文章

评分标准通过以下额外字段扩展了 StudentSubmissions 资源:

  • rubricId 用于标识与提交内容的 CourseWork 对应的评分标准。
  • draftRubricGrades 表示教师在将提交内容发回给学生之前起草的评分标准和占位分数。
  • assignedRubricGrades 表示教师发回提交内容后,学生获得的评分标准和分数。

如需了解如何使用 API 管理评分标准和读取相关成绩,请参阅评分标准 API 指南

评分标准

Google 课堂支持自定义评分标准,例如,允许教师将数字成绩转换为字母成绩。这些设置和相应的数据在 API 中不可用。