本文件介紹與 Classroom API 相關的評分概念。
請參閱「評分及追蹤作業」一文，瞭解 Google Classroom 應用程式中老師評分的流程。
課程作業和提交內容
在 Google Classroom 中，學生會繳交 CourseWork 作業的 StudentSubmissions，並將其放入 Course。CourseWork 可評分或不評分。如果 CourseWork 已評分，則會顯示 maxPoints 值，代表作業的總分。如果 maxPoints 為零或未指定，作業就不會評分。
對於有成績的作業，老師會先在 StudentSubmission 上設定 draftGrade 成績，再發還給學生。在 Classroom 應用程式中傳回提交內容後，StudentSubmission 會自動設定 assignedGrade，其值與目前的 draftGrade 相同。開發人員可以設定這兩個欄位，且必須模擬 Classroom 應用程式的行為。舉例來說，如果沒有 draftGrade，就無法設定 assignedGrade。這兩個欄位都會以小數表示，如果未設定，則表示老師尚未設定對應的成績。如需讀取、設定及傳回成績的程式碼範例，請參閱「建立及管理成績」。
學生可以提交多份 CourseWork 作業，而 StudentSubmission.submissionHistory 會追蹤繳交狀態和成績記錄。
遲交、有正當理由未交和缺交的課程
指派 CourseWork 項目時，系統會為每位學生建立預留位置 StudentSubmissions，即使學生尚未與對應作業互動也一樣。如果學生未在截止日期前繳交作業，老師可以在 CourseWork 上設定 dueDate，而相關聯的 StudentSubmissions 會標示 late 欄位 (設為 true)。老師也可以在 Classroom 應用程式中設定停用逾期繳交作業的功能。
此外，在 dueDate 前未提交的 StudentSubmissions 會在 Classroom 成績單中標註為「缺少」。老師也可以在 Classroom 應用程式中手動將繳交作業標示為缺交。系統會自動為缺交作業提供 draftGrade，老師可以自訂這項資訊，但預設值為 0。
老師可以將缺交的作業標示為「已完成」或「免交」。標示為已完成的 StudentSubmissions 會移除預設的 draftGrade 欄位，直到老師手動設定新的欄位為止。標示為免考的 StudentSubmissions 會從總成績計算中移除，包括評分期間。
如要進一步瞭解老師如何處理提交作業，請參閱「評分及退回作業」說明文章。
整體評分與評分系統
Classroom 支援多種評分系統，可計算學生在課程中的總成績。您可以直接根據總分計算總成績、依類別加權，或完全不計算總成績。
請參閱設定評分系統一文，透過範例瞭解不同的評分系統。
幾個重點如下：
Course資源包含gradebookSettings物件，其中包含課程成績設定的詳細資料。calculationType會指定課程的計算方法。displaySettings會指定哪些人可以在 Classroom 應用程式中查看整體成績。建議您盡可能在自己的應用程式中尊重這項做法。舉例來說，如果學生無法在 Classroom 中查看總成績，請勿在應用程式中向他們顯示這項資訊。gradeCategories包含為課程設定的成績評分類別清單，包括顯示名稱、權重百分比，以及對應作業的預設分數。
- 如果課程使用加權評分，則在沒有類別的情況下，您可能需要將權重正規化。舉例來說，如果類別權重為家庭作業 20%、練習題 10% 和測驗 70%，但實際上沒有練習題，Classroom 會在計算總成績時將權重調整為家庭作業約 22%，測驗約 78%。如果您想在應用程式中複製 Classroom 的整體成績，就必須採取相同做法。
評分週期
老師可以將課程中的CourseWork作業分組為不同的日期範圍，稱為評分期間。您可以使用評分期間在成績單檢視畫面中篩選課程作業，並建立用於計算總成績的不同分類。
舉例來說，老師可能會建立「春季」和「秋季」學期評分期間。春季的整體成績分數只包含春季日期範圍內的 StudentSubmissions。
課程的評分系統會延伸至評分週期。因此，如果在使用加權評分類別的課程中設定上述春季和秋季評分期間，學生最終會有三組總成績：
- 課程所有作業的總成績。
- 春季日期範圍內所有作業的整體成績。
- 這個日期範圍內所有作業的總成績。
這三種方式都會使用加權類別計算總成績。
請參閱評分期間公告，瞭解這項功能的概況。
評分期間會使用 gradingPeriodId 擴充 CourseWork，用於識別作業所屬的評分期間。
請參閱評分週期 API 指南，瞭解如何使用 API 讀取及管理評分週期。
評分量表
老師可以建立 Rubrics，並與 CourseWork 作業建立關聯，然後在評分對應的 StudentSubmissions 時，使用這些評分量表做為指南。
如要瞭解老師如何在 Classroom 中使用評分量表，請參閱評分量表一文。
評分量表會使用其他欄位擴充 StudentSubmissions 資源：
rubricId會指出與提交內容的CourseWork對應的評分標準。draftRubricGrades代表老師在將提交內容發還給學生前，所草擬的評分標準和預留位置分數。assignedRubricGrades代表老師發還繳交內容後，學生會收到的標準和分數。
如要瞭解如何使用 API 管理評量標準及讀取相關成績，請參閱評量標準 API 指南。
評分標準
Classroom 支援可自訂的評分標準，例如讓老師將分數轉換為字母成績。這些設定和對應的資料無法在 API 中使用。