Method: courses.courseWork.rubrics.create

建立評分量表。

這項要求必須由用來建立父項課程工作項目的 OAuth 用戶端 ID 的 Google Cloud 控制台進行。

詳情請參閱評分量表結構和已知限制。

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

  • PERMISSION_DENIED：如果提出要求的使用者不允許為要求的課程作業建立評分量表。
  • 如果要求的 OAuth 範圍不足，則為 INTERNAL。
  • 如果要求格式錯誤且發生以下要求錯誤，則為 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

詳情請參閱授權指南。