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

如需了解详情，请参阅授权指南。