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

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

只读。

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 的预览版本。

用于从现有来源创建评分准则的选项。以下是互斥字段的列表。在响应中,最多只能设置以下字段之一:
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

更新评分准则。