评分准则结构和已知限制

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

评分准则结构

使用此 API 与评分标准交互时，可能需要重点介绍一些重要概念：

  • 与 CourseWork 关联的评分标准最多只有一个，并且该评分标准是该 CourseWork 所独有的（无法在多个 CourseWork 资源中共享）。
  • 评分标准由标准组成，而标准由等级组成。评分标准始终必须包含至少一个评分标准，并且评分标准始终必须包含至少一个等级。
  • 等级可以计分（包含分数），也可以不计分（不计分）。在评分标准中，各个等级必须全部评分或全部不评分。
    • 如果要为等级评分，则必须为条件中的所有等级设置唯一的分值。积分可以是整数（例如 10）或浮点值（例如 9.99）。其中可能包括 0。不接受 null 值。 此外，评分标准中不能有单个评分等级为 0 分的单个评分标准。
    • 如果关卡不计分，则应省略“points”字段；不接受 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 权限范围被视为敏感权限范围，因此您的应用可能需要接受验证。

上一页
评分周期