评分准则结构和已知限制

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

评分准则结构

在使用 API 与评分准则进行交互时，需要强调一些重要概念：

  • 一个 CourseWork 最多只有一条评分准则，并且该评分准则对该 CourseWork 而言是唯一的（无法在多个 CourseWork 资源之间共享）。
  • 评分准则由标准组成，标准包含等级。评分准则必须始终至少有一个条件，并且条件必须始终至少有一个级别。
  • 等级可以是计分（含积分）或不计分（不能计分）。每个等级都必须在评分准则中设定完整分值或完全不打分。
    • 如果对等级有评分，则相应标准中的所有等级都必须设置不重复的分值。点可以是整数（如 10）或浮点值（如 9.99）。其中可能包括 0。不接受 null 值。此外，评分准则不能有一个只有一个等级的标准是 0 分。
    • 如果关卡不计分，则应省略积分字段；不接受 null 值。
  • 条件和等级的顺序有意义，可以反映它们在 Google 课堂界面中的表示顺序。
    • 特别是在得分级别时，必须始终按积分以升序或降序排列。
  • 每个评分准则最多可以有 50 个评分标准，每个评分标准最多可以有 10 个表现等级。

学生提交的内容对象也发生了变化：

  • 除了现有的 draftGrade 和 assignedGrade 属性之外，使用评分准则进行评分的学生提交的内容具有 draftRubricGrades 和 assignedRubricGrades 属性。它们分别表示学生在评分准则中，处于草稿和已分配状态下，在评分期间获得的评分准则成绩（所选等级和分值）。
  • 目前，这些属性都是只读的。这意味着您无法使用该 API 为提交内容评分，但您可以在 Google 课堂界面中阅读已评分的提交内容。
  • 带有关联评分准则的学生提交的作业包含“rubricId”字段。 此字段表示与 CourseWork 相关联的最新评分准则。如果教师删除并重新创建评分准则，此值可能会发生变化。

评分准则行为

该 API 会尽可能镜像 Google 课堂界面以保持一致性，但这可能会导致开发者出现不直观的行为，值得一提：

  • 评分准则旨在指导评分，而不会限制教师。因此，教师在使用评分准则为提交内容评分时，可以执行以下操作：
    • 评分时请完全忽略评分准则。
    • 覆盖该条件的分数，无论该条件级别中的分数如何。
    • 仅为一部分条件选择级别。
    • 在不选择相应的级别的情况下为条件分配分数。
    • 替换作业的总分，而不考虑评分准则中的分。

此外，此 API 也未引入任何新的产品功能。换句话说，此 API 不支持 Google 课堂界面尚未支持的行为。 例如，API 无法像目前那样对作业强制使用评分准则，或覆盖教师修改评分准则和提交内容的权限。

评分时的限制

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

  • 允许对标准及等级标题和说明进行文本修改。
  • 评分标准中的等级排序可能会发生变化。

其他范围

您可以手动将评分准则导出到 Google 电子表格，以供教师重复使用。

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