如果您不熟悉 Classroom 評分量表，請參閱這些說明中心文章，瞭解評分量表的「一般結構」，以及 Classroom UI 中的評分量表評分方式。
評分量表結構
使用 API 與評量表互動時，以下幾個重要概念值得特別強調：
- 最多 (最多) 與
CourseWork相關聯的單一評分量表，且該評分量表專屬於該CourseWork(無法跨CourseWork資源共用)。 - 評量準則由評分標準組成，而評分標準則由等級組成。評量準則一律須包含至少一個條件，而條件一律須包含至少一個等級。
- 您可以為關卡計分 (有分數) 或不計分 (沒有分數)。評分量表中的等級必須等於或完全未計分。
- 如果要評分等級，則每個準則中的所有等級都必須設有專屬的分數值。分數可以是整數 (例如 10) 或浮點值 (例如 9.99)。這可能包括 0。不接受空值。此外，評分量表不能有 0 分之單一標準。
- 如果沒有評分，請省略「點數」欄位；系統不接受空值。
- 條件和等級的順序具有意義，並反映 Classroom 使用者介面中的順序。
- 請特別注意，務必按照遞增或遞減順序按照分數排序。
- 每個評分量表最多可包含 50 項準則，每項準則最多可分為 10 個表現等級。
相關學生提交作業欄位
學生提交內容物件也會有所變更：
- 除了現有的
draftGrade和assignedGrade屬性之外，使用評量表評分的學生提交內容也有draftRubricGrades和assignedRubricGrades屬性。這些值分別代表學生在草稿和指派狀態下，透過評分量表獲得的評分 (所選等級和分數值)。 - 目前這些屬性為唯讀。也就是說，API 無法用於評分提交內容，但您可以在 Classroom UI 中讀取已評分的提交內容。
- 學生繳交的作業如果含有相關聯的評分量表，就會包含
rubricId欄位。這個欄位代表與CourseWork相關聯的最新評分量表，如果老師刪除並重新建立評分量表，這個值可能會有所變更。
評分量表行為
這個 API 旨在盡可能鏡像 Classroom 使用者介面，以確保一致性，但這可能會導致開發人員不易理解的行為，因此值得一提：
- 評量準則的用意是引導老師評分，但不限制老師的評分方式。因此，老師在使用評量標準評分提交內容時，可以執行下列操作：
- 評分時完全忽略評分量表。
- 覆寫準則的分數，不論準則的等級可用的分數為何。
- 只為部分準則選取等級。
- 為準則指派分數，但不選取對應的等級。
- 無論評分量表會給予多少分數，皆可覆寫作業的總分。
此外，這個 API 不會推出任何新產品功能。換句話說，API 不支援 Classroom UI 尚未提供的行為。例如，這個 API 就不會在作業中強制使用評分量表，也無法覆寫老師目前的評分量表編輯和繳交功能。
評分期間的限制
同樣地，一旦老師開始使用評分量表評分，就無法編輯評分量表。評分作業開始後，您只能進行下列編輯：
- 您可以編輯準則和等級的標題和說明。
- 您可以在條件內變更等級順序。
其他範圍
您可以手動匯出評量標準至 Google 試算表，方便老師重複使用。
如果您要透過這些試算表建立或更新評量標準 (請參閱指南中的範例)，應用程式就必須要求 https://www.googleapis.com/auth/spreadsheets.readonly 或 https://www.googleapis.com/auth/spreadsheets 範圍。請注意，spreadsheets 範圍屬於敏感範圍，可能需要將應用程式經過驗證。