評分量表和已知限制

如果不熟悉 Classroom 評分量表，歡迎參閱這些說明中心文章 評分量表的一般架構以及評分量表評分的運作方式 也別忘了善加利用 Classroom UI

評分量表結構

使用 與評分量表互動的 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 範圍視為敏感範圍，可能需要應用程式才能使用 進行驗證。