評分量表和已知限制

如果您不熟悉 Classroom 評分量表，請參閱這篇說明中心文章，瞭解評分量表的一般結構，以及如何在 Classroom 使用者介面中進行評分量表評分。

評分量表結構

使用 API 與評分量表互動時，請注意以下幾個重要概念：

  • 有一個 (最多) 與 CourseWork 相關聯的單一評分量表，且該評分量表是該 CourseWork 獨有的 (無法跨 CourseWork 資源共用)。
  • 評分量表由條件組成，由「層級」組成。評分量表一律至少須有一個條件，且一個條件必須至少有一個標準。
  • 等級可分為 (有積分) 或未計分 (無分數)。等級必須完全計分或未計分。
    • 如果等級已得分，則條件中的所有等級都必須具有不重複的分數值。路徑點可以是整數 (例如 10) 或浮點值 (例如 9.99)。可以是 0。不接受空值。 此外，單一評分量表不能設定單一等級為 0 分的單一條件。
    • 如果等級未計分，應省略分數欄位；不接受空值。
  • 條件和等級的順序很有意義的，並且會反映 Classroom UI 中這些條件的順序。
    • 特別注意的分數等級必須依遞增或遞減順序排序。
  • 每個評分量表最多可有 50 個條件，而每個標準最多可有 10 個效能等級。

「學生繳交的作業」物件也有所變更：

  • 除了現有的 draftGrade 和 assignedGrade 屬性外，使用評分量表評分的學生作業還擁有 draftRubricGrades 和 assignedRubricGrades 屬性。這些分數代表學生從評分量表評分時獲得的評分量表成績 (選取等級和分數值)，分別呈現草稿和指派狀態。
  • 這些屬性目前為唯讀屬性。這表示該 API 無法用於批改繳交的作業，但可以在 Classroom UI 中讀取已評分的提交內容。
  • 與相關評分量表相關的學生繳交的作業會包含 rubricId 欄位。 這個欄位代表與 CourseWork 相關聯的最新評分量表，如果老師刪除並重新建立評分量表，這個值可能會改變。

評分量表行為

這個 API 旨在盡可能模擬 Classroom 使用者介面以維持一致性，但這可能會導致開發人員無法理解，因此值得注意：

  • 評分量表旨在引導評分，而不會對老師造成乾擾。因此，透過評分量表對繳交的作業評分時，老師可以執行下列動作：
    • 完成評分時完全忽略評分量表。
    • 無論條件層級中可用的資料點為何，您都可以覆寫準則的分數。
    • 僅為部分條件選取等級。
    • 您不必選取相應的等級，即可指派準則的分數。
    • 覆寫作業的總分，無論評分量表中的分數為何。

此外，這個 API 並未推出任何新的產品功能。換句話說，這個 API 不支援 Classroom 使用者介面目前沒有的行為。舉例來說，API 不會像現在一樣，在作業上強制執行評分量表，也不會覆寫老師編輯評分量表和繳交項目的權限。

評分限制

同樣地，老師開始對評分量表進行評分後，還需要一些其他限制。開始評分後，只能進行以下編輯：

  • 條件和等級的標題和說明可以編輯文字。
  • 等級排序可在條件內變更。

其他範圍

評分量表可手動匯出至 Google 試算表，供老師重複使用。

如果您透過這些試算表建立或更新評分量表 (請參閱指南中的範例)，應用程式必須要求 https://www.googleapis.com/auth/spreadsheets.readonly 或 https://www.googleapis.com/auth/spreadsheets 範圍。請注意，spreadsheets 範圍屬於敏感範圍，您可能需要應用程式通過驗證。