Method: courses.courseWork.rubrics.patch

更新评分准则。

如需详细了解可以更新哪些字段，请参阅 google.classroom.v1.Rubric。开始评分后，评分准则更新功能会受到限制。

此请求必须由用于创建父级课程作业项目的 OAuth 客户端 ID 的 Google Cloud 控制台发出。

此方法会返回以下错误代码：

  • 如果发出请求的开发者项目没有创建相应的课程作业、不允许用户按照要求修改评分准则，或存在访问错误，则为 PERMISSION_DENIED。如果评分准则已开始评分，系统也会返回此错误代码。
  • 如果请求格式不正确，并且存在以下请求错误，则返回 INVALID_ARGUMENT：
    • RubricCriteriaInvalidFormat
  • 如果请求的课程、课程作业或评分准则不存在，或者用户无权访问相应的课程作业，则为 NOT_FOUND。
  • 如果评分准则中已开始评分，则为 INTERNAL。

HTTP 请求

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}

网址采用 gRPC 转码语法。

路径参数

参数
courseId

string

必需。课程的标识符。
courseWorkId

string

必需。课程作业的标识符。
id

string

可选。评分准则的标识符。

查询参数

参数
updateMask

string (FieldMask format)

可选。用于标识评分准则中要更新的字段的掩码。要进行更新，必须填写此字段。如果指定了无效字段，更新将失败。您可以通过多个选项来定义评分准则的标准：sourceSpreadsheetId 和 criteria 列表。一次只能使用其中一个字段定义评分准则。

评分准则的 criteria 列表会完全替换为更新请求中指定的评分准则。例如，如果请求中缺少某个条件或级别，系统会将其删除。系统会添加新的条件和级别，并分配 ID。如果在请求中指定 ID，现有的条件和级别会保留之前分配的 ID。

教师可以指定以下字段：

  • criteria
  • sourceSpreadsheetId

这是以逗号分隔的完全限定字段名称列表。示例："user.displayName,photo"。
previewVersion

enum (PreviewVersion)

可选。API 的预览版本。必须设置此字段，才能使用预览版计划中为开发者提供的新 API 功能。

请求正文

请求正文包含一个 Rubric 实例。

响应正文

如果成功，则响应正文包含一个 Rubric 实例。

授权范围

需要以下 OAuth 作用域：

  • https://www.googleapis.com/auth/classroom.coursework.students

有关详情，请参阅授权指南。