REST Resource: courses.courseWork.rubrics

資源：評分量表

課程作業的評分規準。評分量表是評分指南，可做為評估學生作業和提供意見回饋的依據。

詳情請參閱「評量表結構和已知限制」。

JSON 表示法 
{
  "courseId": string,
  "courseWorkId": string,
  "id": string,
  "creationTime": string,
  "updateTime": string,
  "criteria": [
    {
      object (Criterion)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  "sourceSpreadsheetId": string
}
欄位
courseId

string

課程的 ID。

唯讀。
courseWorkId

string

對應的課程作業 ID。

唯讀。
id

string

系統為評量表指派的 ID。相關課程作業的評量表不得重複。

唯讀。
creationTime

string (Timestamp format)

僅供輸出。建立評分量表的時間戳記。

唯讀。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

僅供輸出。這個評量表最近一次變更的時間戳記。

唯讀。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
criteria[]

object (Criterion)

條件清單。每個準則都是評估成效的維度。
previewVersion

enum (PreviewVersion)

僅供輸出。用於擷取這項資源的 API 預覽版。
聯集欄位 rubric_source。可從現有來源建立評分量表。rubric_source 只能是下列其中一項：
sourceSpreadsheetId

string

僅供輸入。不可變動。試算表的 Google 試算表 ID。這個試算表必須包含格式化的評量標準設定。請參閱「建立或重複使用作業評分量表」。使用這個欄位時，必須具備 https://www.googleapis.com/auth/spreadsheets.readonly 或 https://www.googleapis.com/auth/spreadsheets 範圍。

條件

評分量表標準。每個準則都是評估成效的維度。

JSON 表示法 
{
  "id": string,
  "title": string,
  "description": string,
  "levels": [
    {
      object (Level)
    }
  ],
  "learningGoal": {
    object (LearningGoal)
  }
}
欄位
id

string

條件 ID。

建立時，系統會指派 ID。
title

string

準則的標題。
description

string

準則說明。
levels[]

object (Level)

這項標準內的層級清單。
learningGoal

object (LearningGoal)

(選用步驟)

與這項準則相關聯的學習目標。只有在設定適當的 PreviewVersion 時，才會填入這個欄位。

等級

準則的等級。

JSON 表示法 
{
  "id": string,
  "title": string,
  "description": string,
  "points": number
}
欄位
id

string

層級 ID。

建立時，系統會指派 ID。
title

string

關卡名稱。

如果等級未設定點數，則必須設定名稱。
description

string

等級說明。
points

number

與這個等級相關的選用點數。如果設定了分數，評分量表中的所有等級都必須指定分數，且單一準則內所有等級的分數值不得重複。0 分與沒有分數不同。

方法

create

 建立評分量表。

delete

 刪除評分量表。

get

 傳回評分量表。

list

 傳回要求者有權查看的評量表清單。

patch

 更新評分量表。