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

系統為評量表指派的 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.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

更新評分量表。