Method: courses.courseWork.rubrics.create

建立評分量表。

提出要求的使用者和課程擁有者必須具備評量標準建立權限。詳情請參閱授權規定

詳情請參閱「評量標準結構和已知限制」。

這項要求必須透過 Google Cloud 控制台的 OAuth 用戶端 ID 提出,用於建立父項課程作業項目。

這個方法會傳回下列錯誤代碼:

  • 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

必要欄位。課程的 ID。

courseWorkId

string

必要欄位。課程作業的 ID。

查詢參數

參數
previewVersion

enum (PreviewVersion)

選用設定。API 的預覽版。您必須設定此值,才能存取預覽計畫中提供給開發人員的新 API 功能。

要求主體

要求主體包含 Rubric 的例項。

回應主體

如果成功,回應主體會包含新建立的 Rubric 例項。

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱授權指南