評分量表和已知限制

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

評分量表結構

使用 API 與評量表互動時，以下幾個重要概念值得特別強調：

  • 最多只有一個評分標準與 CourseWork 相關聯，且該評分標準專屬於該 CourseWork (無法跨 CourseWork 資源共用)。
  • 評量準則由評分標準組成，而評分標準則由等級組成。評量準則一律須包含至少一項評量標準，而評量標準一律須包含至少一個等級。
  • 您可以為關卡計分 (有分數) 或不計分 (沒有分數)。評量準則中必須完全給分或完全不給分。
    • 如果要評分等級，則每個準則中的所有等級都必須設有專屬的分數值。點數可以是整數 (例如 10) 或浮點值 (例如 9.99)。這可能包括 0。不接受空值。此外，評量準則中不得有單一條件，且單一等級的點數為 0。
    • 如果沒有評分，請省略「點數」欄位；系統不接受空值。
  • 條件和等級的順序具有意義，並反映 Classroom 使用者介面中的順序。
    • 特別是分數等級，必須一律以分數遞增或遞減的順序排序。
  • 每個評分量表最多可包含 50 項準則，每項準則最多可分為 10 個表現等級。

StudentSubmission 物件支援評量標準相關欄位：

  • 除了現有的 draftGrade 和 assignedGrade 屬性之外，使用評量表評分的學生提交內容也有 draftRubricGrades 和 assignedRubricGrades 屬性。這些值分別代表學生在草稿和指派狀態下，透過評分量表獲得的評分 (所選等級和分數值)。
  • 這些屬性目前為唯讀。也就是說，API 無法用於評分提交內容，但您可以透過 Classroom UI 查看已評分的提交內容。

評分量表行為

這個 API 旨在盡可能鏡像 Classroom 使用者介面，以確保一致性，但這可能會導致開發人員不易理解的行為，值得一提：

  • 評量準則的用意是引導老師評分，但不限制老師的評分方式。因此，老師在使用評量標準評分提交內容時，可以執行下列操作：
    • 評分時完全忽略評分量表。
    • 覆寫準則的分數，不論準則等級可用的分數為何。
    • 只為部分準則選取等級。
    • 為準則指派分數，但不選取對應的等級。
    • 不論評分量表的總分為何，都會覆寫作業的總分。

此外，API 不支援 Classroom UI 不具備的行為。舉例來說，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 建立、更新及刪除評量標準：

請參閱「使用者資格條件」，進一步瞭解如何向使用者提供 API 功能，以及 Classroom API 前置條件，讓您熟悉並申請開發用途的示範帳戶。

上一頁
評分期間