評分量表和已知限制

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

評分量表結構

使用 API 與評量表互動時，建議特別注意以下幾個重要概念：

• 每個 CourseWork 最多只能有一個相關聯的評量表，且該評量表專屬於該 CourseWork (無法在 CourseWork 資源之間共用)。
• 評量表由評量標準組成，而評量標準又由等級組成。評量表至少須包含一項評量標準，而評量標準至少須包含一個等級。
• 等級可以計分 (有分數) 或不計分 (沒有分數)。評分量表中的所有等級都必須評分或不評分。
  • 如果層級有分數，準則中的所有層級都必須設定不重複的分數值。分數可以是整數 (例如 10) 或浮點值 (例如 9.99)。包括 0。不接受空值。 此外，評分量表不得只有一項準則，且該準則只有一個等級，且為 0 分。
  • 如果等級未評分，則應省略分數欄位；系統不接受空值。
• 準則和等級的順序具有意義，反映了這些項目在 Classroom 使用者介面中的顯示順序。
  • 特別是評分等級，一律須依分數遞增或遞減排序。
• 每個評分量表最多可包含 50 項準則，每項準則最多可分為 10 個表現等級。

相關的學生繳交作業欄位

StudentSubmission 物件支援與評量表相關的欄位：

• 除了現有的 draftGrade 和 assignedGrade 屬性之外，以評量表評分的學生提交內容還具有 draftRubricGrades 和 assignedRubricGrades 屬性。這些分別代表學生在評分期間，從評分量表獲得的評分量表成績 (所選等級和分數值)，以及草稿和已指派狀態。
• 這些資源目前僅供讀取，也就是說，您無法使用 API 評估提交內容，但可以讀取在 Classroom 使用者介面中評估的提交內容。

評分量表行為

為確保一致性，API 會盡可能反映 Classroom 使用者介面，但這可能會導致開發人員覺得不直覺的行為，因此值得一提：

• 評量表旨在引導評分，不會限制老師。因此，老師在透過評分表為提交內容評分時，可以執行下列動作：
  • 評分時完全忽略評分量表。
  • 覆寫準則的分數，無論準則等級的分數為何。
  • 只為部分準則選取等級。
  • 為準則指派分數，但未選取對應等級。
  • 覆寫作業總分，無論評分量表的分數為何。

此外，如果 Classroom 使用者介面尚未提供某項功能，API 也不支援該功能。舉例來說，API 無法強制在作業中使用評量表，也無法像現在一樣，覆寫老師編輯評量表和提交內容的權限。

評分期間的限制

同樣地，老師開始使用評分量表評分後，編輯評分量表時也會受到一些額外限制。評分開始後，只能進行下列編輯：

• 您可以編輯準則和等級的名稱和說明。
• 等級順序可能會在條件內變更。

其他範圍

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

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

第三方課程

只有建立上層 CourseWork 項目時使用的 Google Cloud 專案，才能建立評量表。這是 Classroom API 中更廣泛的設計模式，可防止不同應用程式影響不屬於自己的資源。

這也包括使用者在 Classroom 應用程式中建立的資源。舉例來說，即使老師擁有應用程式，應用程式也無法管理老師在 Classroom 使用者介面中建立的課程作業評量表。如果這項限制嚴重影響您的用途，請在公開問題追蹤工具中分享意見回饋。

執照規定

如要使用 Classroom API 建立、更新及刪除評量表，使用者必須符合下列條件：

• 提出要求的使用者已獲派 Google Workspace for Education Plus 授權。
• 相應課程的擁有者已獲派 Google Workspace for Education Plus 授權。

請參閱使用者資格，進一步瞭解如何向使用者公開 API 功能，並參閱 Classroom API 先決條件，熟悉開發用的示範帳戶並提出申請。