如果您不熟悉 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
范围被视为敏感范围,可能需要验证您的应用。