评分准则结构和已知限制

如果您不熟悉 Google 课堂中的评分标准，请参阅以下帮助中心文章，了解评分标准的一般结构以及如何在 Google 课堂界面中进行评分标准评分。

评分准则结构

使用 API 与评分标准互动时，有一些重要的概念可能值得重点介绍：

  • 一个 CourseWork 最多只能关联一个评分标准，并且该评分标准对于相应 CourseWork 而言是唯一的（无法在多个 CourseWork 资源之间共享）。
  • 评分标准由标准组成，而标准又由等级组成。评分标准必须始终至少包含一个评分标准，而评分标准必须始终至少包含一个等级。
  • 关卡可以计分（有分数），也可以不计分（没有分数）。在评分标准中，级别必须完全得分或完全不得分。
    • 如果对级别进行评分，则一个条件中的所有级别都必须设置唯一的分值。积分可以是整数（例如 10），也可以是浮点数值（例如 9.99）。这可以包括 0。系统不接受 null 值。 此外，评分标准不能包含单个等级为 0 分的单个标准。
    • 如果关卡不计分，则应省略 points 字段；系统不接受 null 值。
  • 标准和等级的顺序具有实际意义，反映了它们在 Google 课堂界面中的显示顺序。
    • 尤其是计分等级，必须始终按积分升序或降序排序。
  • 在同一评分准则中，您最多可以创建 50 条评分标准，并最多可为每条评分标准创建 10 个表现等级。

StudentSubmission 对象支持与评分标准相关的字段：

  • 除了现有的 draftGrade 和 assignedGrade 属性之外，使用评分标准评分的学生提交内容还具有 draftRubricGrades 和 assignedRubricGrades 属性。这些分别表示学生在评分期间从评分标准中获得的评分标准成绩（所选等级和分值）（处于草稿和已布置状态）。
  • 目前，这些属性是只读的。这意味着该 API 无法用于对提交内容进行评分，但您可以读取在 Classroom 界面中评分的提交内容。

评分标准行为

为了保持一致性，该 API 旨在尽可能地镜像 Google 课堂界面，但这可能会导致开发者难以理解的行为，因此值得一提：

  • 评分标准旨在指导评分，同时又不限制教师。因此，教师在通过评分标准为提交内容评分时可以执行以下操作：
    • 在评分时完全忽略评分准则。
    • 替换某个评分标准的分数，而不论该评分标准等级中提供的分数是多少。
    • 仅为部分评分标准选择等级。
    • 为评分标准分配了分数，但未选择相应的等级。
    • 替换作业的总分，无论评分标准会产生多少分。

此外，该 API 不支持 Google 课堂界面尚不具备的行为。例如，该 API 无法强制要求在作业中使用评分标准，也无法像现在这样替换教师编辑评分标准和提交内容的能力。

评分期间的限制

同样，教师开始使用评分准则打分后，在修改评分准则时会受到一些额外的限制。在评分开始后，只能进行以下修改：

  • 允许对标准和等级的标题及说明进行文字修改。
  • 级别顺序可以在条件内更改。

其他范围

教师可以手动将评分标准导出到 Google 电子表格，以便日后重复使用。

如果您通过这些电子表格创建或更新评分标准（请参阅指南中的示例），您的应用需要请求 https://www.googleapis.com/auth/spreadsheets.readonly 或 https://www.googleapis.com/auth/spreadsheets 范围。请注意，spreadsheets 范围被视为敏感范围，可能需要您的应用通过验证。

第三方课程

只有创建父级 CourseWork 项的 Google Cloud 项目才能创建评分标准。这是 Classroom API 中更广泛的设计模式，可防止不同的应用影响不属于自己的资源。

这同样适用于用户在 Google 课堂应用中创建的资源。例如，即使教师是某个应用的所有者，该应用也无法管理教师在 Google 课堂界面中创建的作业的评分标准。如果这严重限制了您的使用情形，请在公开问题跟踪器中分享反馈。

执照要求

只有在满足以下条件时，用户才能使用 Classroom API 创建、更新和删除评分标准：

请参阅用户资格要求，详细了解如何向用户公开 API 功能；另请参阅 Classroom API 前提条件，熟悉并申请用于开发的演示账号。

上一页
评分周期