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

Classroom 指派的評分量表 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 預先發布版。

從現有來源建立評分量表的選項。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位:
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

更新評分量表。