如果您不熟悉 Google 课堂评分标准，请参阅以下帮助中心文章，了解评分标准的一般结构以及如何在 Google 课堂界面中按评分标准评分。
评分准则结构
使用 API 与评分标准交互时，以下一些重要概念可能值得强调：
- 与
CourseWork关联的评分标准最多只有一个，并且该评分标准是该CourseWork所独有的（无法在多个CourseWork资源中共享）。 - 评分标准由标准组成，标准由等级组成。评分标准始终必须包含至少一个评分标准，而评分标准始终必须包含至少一个等级。
- 等级可以设分（有分数），也可以不设分（无分数）。在评分标准中，各个等级必须全部评分或全部不评分。
- 如果要为等级评分，则必须为条件中的所有等级设置唯一的分值。积分可以是整数（例如 10）或浮点值（例如 9.99）。这可能包括 0。不接受 null 值。此外，评分标准中不能有单个评分等级为 0 分的单个评分标准。
- 如果关卡未评分，则应省略 points 字段；不接受 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 创建、更新和删除评分标准：
- 提出请求的用户已获配 Google Workspace 教育 Plus 版许可。
- 相应课程的课程所有者拥有分配给他们的 Google Workspace 教育 Plus 版许可。
如需详细了解如何向用户公开 API 功能以及 Classroom API 的前提条件，请参阅用户资格条件，以熟悉并申请用于开发的演示账号。