REST Resource: courses.courseWork.rubrics

資源:評分量表

課程作業的評分量表。評分量表是一種評分指南,可用來評估學生作業並提供意見回饋。

詳情請參閱評分量表結構和已知限制

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

  // Union field rubric_source can be only one of the following:
  "sourceSpreadsheetId": string
  // End of list of possible types for union field rubric_source.
}
欄位
courseId

string

課程的 ID。

唯讀。

courseWorkId

string

此為課程對應的 ID。

唯讀。

id

string

Classroom 指派的評分量表 ID。這點與其他相關課程作業的評分量表不同。

唯讀。

creationTime

string (Timestamp format)

僅供輸出。這個評分量表的建立時間。

唯讀。

RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

僅供輸出。這個評分量表近期變更的時間戳記。

唯讀。

RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

criteria[]

object (Criterion)

準則清單。每個條件都是用來評分的維度。

previewVersion

enum (PreviewVersion)

僅供輸出。用來擷取這項資源的 API 預覽版本。

聯集欄位 rubric_source。從現有來源建立評分量表的選項。rubric_source 只能是下列其中一項:
sourceSpreadsheetId

string

僅限輸入。不可變動。試算表的 Google 試算表 ID。這份試算表必須包含格式化評分量表設定。請參閱「建立或重複使用作業評分量表」一文。需要 https://www.googleapis.com/auth/spreadsheets.readonlyhttps://www.googleapis.com/auth/spreadsheets 範圍,才能使用這個欄位。

條件

評分量表準則。每個條件都是用來評分的維度。

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

string

條件 ID。

建立時,系統會指派 ID。

title

string

條件的名稱。

description

string

條件的說明。

levels[]

object (Level)

此條件內的層級清單。

層級

條件的層級。

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

更新評分量表。