本文档介绍了与 Google 课堂 API 相关的评分概念。
请参阅为作业评分和跟踪作业一文，了解教师在 Google 课堂应用中的评分流程。
课业和提交内容
在 Google 课堂中，学生可以在Course中针对CourseWork作业提交StudentSubmissions。CourseWork 可以是已评分的，也可以是不评分的。如果 CourseWork 已评分，则具有 maxPoints 值，该值表示作业的总分数。如果 maxPoints 为零或未指定，则作业将不计分。
对于已评分的作业，教师会先在 StudentSubmission 上为其设置 draftGrade 成绩，然后再将其发回给学生。当 Google 课堂应用中返回提交内容时，系统会自动在 StudentSubmission 上设置 assignedGrade，其值与当前 draftGrade 相同。开发者可以设置这两个字段，并且必须模拟 Google 课堂应用的行为。例如，没有 draftGrade 就无法设置 assignedGrade。这两个字段均以小数表示。如果未设置，则表示教师尚未设置相应的成绩。
如需查看用于读取、设置和返回成绩的代码示例，请参阅创建和管理成绩。
学生可以对同一 CourseWork 作业提交多次，系统会在 StudentSubmission.submissionHistory 中跟踪提交状态和成绩历史记录。
课程作业迟交、免除和缺交
分配 CourseWork 项时，系统会为每位学生创建占位符 StudentSubmissions，即使学生尚未与相应作业互动也是如此。教师可以在 CourseWork 上设置 dueDate，如果学生未在该日期之前提交作业，则关联的 StudentSubmissions 会被标记为 late 字段（设为 true）。教师还可以在 Google 课堂应用中通过设置停用延迟提交。
此外，在 dueDate 之前未提交的 StudentSubmissions 会在 Google 课堂评分册中注释为缺失。教师还可以在 Google 课堂应用中手动将提交内容标记为缺失。缺交的作业会自动获得 draftGrade（教师可以自定义该值，但默认值为 0）。
教师可以将缺失的作业标记为已完成或已免除。被标记为已完成的 StudentSubmissions 的默认 draftGrade 字段会被移除，直到教师手动设置新的字段。标记为“免除”的 StudentSubmissions 将从总体成绩计算（包括评分周期）中移除。
如需详细了解教师如何处理提交的作业，请参阅为作业评分和返回作业这篇帮助文章。
总体成绩和评分系统
Google 课堂支持多种评分系统，用于计算学生在课程中的总成绩。总体成绩可以直接根据总分计算，也可以按类别加权计算，也可以不计算。
请参阅设置评分一文，通过示例了解不同的评分系统。
一些要点：
Course资源包含一个gradebookSettings对象，其中包含有关课程成绩设置的详细信息。calculationType用于指定课程的计算方法。displaySettings用于指定哪些人可以在 Google 课堂应用中查看总成绩。最佳实践是，尽可能在您自己的应用中遵循此规则。例如，如果学生在 Google 课堂中无法查看自己的总体成绩，请不要在您的应用中显示该成绩。gradeCategories包含为课程配置的评分类别列表，其中包括相应作业的显示名称、加权百分比和默认分。
- 如果课程使用加权评分，在没有某个类别的情况下，您可能需要对权重进行标准化处理。例如，如果类别权重为家庭作业 20%、练习题 10%、知识问答 70%，但实际上没有练习题，则 Google 课堂会在计算总成绩时将权重调整为家庭作业约 22%、知识问答约 78%。如果您打算在应用中镜像 Google 课堂的总体成绩，则需要执行相同的操作。
评分周期
教师可以将课程中的CourseWork作业划分为不同的日期范围（称为评分周期）。评分周期可用于在成绩册视图中过滤课程作业，并为计算总体成绩创建不同的分桶。
例如，教师可以创建“春季”和“秋季”学期评分周期。春季的总体成绩分数将仅包含在春季日期范围内到期的 StudentSubmissions。
为课程设置的评分系统会应用于评分周期。因此，如果在使用加权评分类别的课程中设置上述春季和秋季评分周期示例，学生最终将有三套总体成绩：
- 课程中所有作业的总体成绩。
- 春季日期范围内所有作业的总体成绩。
- 秋季日期范围内所有作业的总成绩。
这三种方式都会根据加权类别计算总体成绩。
请参阅评分周期通知，大致了解此功能。
评分周期通过 gradingPeriodId 扩展 CourseWork，用于标识作业所属的评分周期。
请参阅评分周期 API 指南，了解如何使用该 API 读取和管理评分周期。
评分准则
教师可以创建 Rubrics 并将其与 CourseWork 作业相关联，并在为相应的 StudentSubmissions 评分时将这些评分准则用作指导。
请参阅评分标准文章，了解教师如何在 Google 课堂中使用评分标准。
评分标准使用其他字段扩展了 StudentSubmissions 资源：
rubricId用于标识与提交内容的CourseWork对应的评分标准。draftRubricGrades表示教师在将提交内容发回给学生之前拟定的标准和占位分数。assignedRubricGrades表示教师发回提交内容后，学生获得的评分标准和分数。
请参阅评分准则 API 指南，了解如何使用该 API 管理评分准则和读取相关成绩。
评分标准
Google 课堂支持自定义评分标准，例如，允许教师将数字成绩转换为字母成绩。这些设置和相应数据在 API 中不可用。