Method: courses.courseWork.rubrics.create

创建评分准则。

发出请求的用户和课程所有者必须具有评分标准创建权限。如需了解详情,请参阅许可要求

如需了解详情,请参阅标题结构和已知限制

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

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

  • PERMISSION_DENIED,如果请求的用户无权为请求的课程中的作业创建评分标准。
  • INTERNAL,如果请求的 OAuth 范围不足。
  • INVALID_ARGUMENT,如果请求格式有误,以及出现以下请求错误
    • RubricCriteriaInvalidFormat
  • 如果请求的课程或课业不存在,或者用户无权访问相应课程或课业,则返回 NOT_FOUND
  • FAILED_PRECONDITION 出现以下请求错误
    • AttachmentNotVisible

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
courseId

string

必需。课程的标识符。

courseWorkId

string

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

查询参数

参数
previewVersion

enum (PreviewVersion)

可选。API 的预览版。必须设置此属性,才能使用预览版计划中向开发者提供的新 API 功能。

请求正文

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

响应正文

如果成功,响应正文将包含一个新创建的 Rubric 实例。

授权范围

需要以下 OAuth 范围:

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

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