評分量表和已知限制

如果不熟悉 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 建立、更新及刪除評量表，使用者必須符合下列條件：

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

上一頁
評分期間