评分准则结构和已知限制

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

评分准则结构

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

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

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

  • 除了现有的 draftGrade 和 assignedGrade 属性之外，使用评分准则评分的学生提交的作业还具有 draftRubricGrades 和 assignedRubricGrades 属性。这些属性分别表示学生在评分准则评分期间收到的评分准则分数（所选等级和分数值）处于草稿和已分配状态。
  • 目前，这些属性是只读属性。这意味着 无法使用 API 对提交的作业进行评分，但您可以读取在 Google 课堂界面中评分的提交作业。

评分准则行为

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

  • 评分准则旨在 指导 评分，而不会限制教师。因此，教师在使用评分准则对提交的作业进行评分时，可以执行以下操作：
    • 在评分时完全忽略评分准则。
    • 替换评分标准的分数，无论评分标准的等级中可用的分数是多少。
    • 仅为部分评分标准选择等级。
    • 为评分标准分配分数，而不选择相应的等级。
    • 替换作业的总分，无论评分准则中的分数是多少。

此外，API 不支持 Google 课堂界面中尚不具备的行为。例如，API 不支持对作业强制使用评分准则，也不支持替换教师编辑评分准则和提交作业的能力（与现在一样）。

评分期间的限制

同样，一旦教师开始使用评分准则进行评分，对评分准则的编辑也会受到一些额外的限制。开始评分后，只能进行以下编辑：

  • 允许对评分标准和等级标题及说明进行文本编辑。
  • 可以在评分标准内更改等级顺序。

其他范围

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

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

第三方课程作业

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

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

执照要求

只有满足以下条件，用户才能使用 Google 课堂 API 创建、更新和删除评分准则：

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

上一页
评分周期