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

课程的标识符。

只读。

courseWorkId

string

此课程作业对应的课程作业的标识符。

只读。

id

string

Classroom 为评分准则分配的标识符。此标识符在相关课程作业的评分准则中是唯一的。

只读。

creationTime

string (Timestamp format)

仅限输出。创建此评分准则时的时间戳。

只读。

采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 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 规范化(即转换为 UTC 零时区格式并在末尾附加 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)
    }
  ],
  "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

更新评分准则。