成績

本文將介紹與 Classroom API 相關的評分概念。

如要瞭解老師在 Google Classroom 應用程式中的評分流程，請參閱查看成績及追蹤作業一文。

CourseWork 和 StudentSubmissions

在 Google Classroom 中，學生會透過StudentSubmissionsCourseWorkCourse 繳交作業。CourseWork可評分或不評分。如果 CourseWork 經過評分，就會有 maxPoints 值，代表作業的總分。如果 maxPoints 為零或未指定，作業就會標示為未評分。

如果是已評分的作業，老師必須先draftGrade設定成績StudentSubmission，再發還給學生。在 Classroom 應用程式中退還作業時，系統會自動在 StudentSubmission 上設定 assignedGrade，值與目前的 draftGrade 相同。開發人員可以設定這兩個欄位，但必須模擬 Classroom 應用程式的行為。舉例來說，如果沒有 draftGrade，就無法設定 assignedGrade。這兩個欄位都以十進位數表示，如果未設定，則表示老師尚未設定相應的成績。如需讀取、設定及傳回成績的程式碼範例，請參閱「建立及管理成績」。

學生可以針對同一項CourseWork作業多次繳交，而系統會在StudentSubmission.submissionHistory中追蹤繳交狀態和成績記錄。

遲交、豁免和缺交的作業

指派 CourseWork 項目後，系統會為每位學生建立預留位置 StudentSubmissions，即使學生尚未與對應的作業互動也一樣。老師可以在 dueDate 上設定 CourseWork，如果學生未在該日期前繳交作業，相關聯的 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

課程的評分系統會套用至評分週期。因此，如果上述春季和秋季的評分週期是針對使用加權評分類別的課程設定，學生最終會有三組總成績：

• 課程中所有作業的總成績。
• 春季日期範圍內所有作業的總成績。
• 秋季日期範圍內所有作業的總成績。

這三種方式都會使用加權類別計算總成績。

如要瞭解這項功能，請參閱成績結算週期公告。

評分期間會以 CourseWork 擴展，並以 gradingPeriodId 識別作業所屬的評分期間。

如要瞭解如何透過 API 讀取及管理評分週期，請參閱評分週期 API 指南。

評分量表

老師可以建立 Rubrics 並與 CourseWork 作業建立關聯，並在為相應的 StudentSubmissions 評分時，將這些評分量表做為參考依據。

如要瞭解老師如何在 Classroom 中使用評分量表，請參閱這篇文章。

評量表會在StudentSubmissions資源中加入其他欄位：

• rubricId 找出與提交內容對應的評量規準。CourseWork
• draftRubricGrades 代表老師在將提交內容發還給學生前，草擬的評分標準和預估分數。
• assignedRubricGrades 代表老師發還作業後，學生獲得的評估標準和分數。

如要瞭解如何透過 API 管理評量表及讀取相關成績，請參閱評量表 API 指南。

評分標準

Classroom 支援自訂評分標準，例如：老師可將分數轉換為等第。API 不提供這些設定和對應資料。