Method: courses.courseWork.rubrics.create

• HTTP 要求
• 路徑參數
• 查詢參數
• 要求主體
• 回應主體
• 授權範圍

開發人員預覽版：可透過 Google Workspace 開發人員預覽版計畫加入，搶先體驗特定功能。這項功能適用於 V1_20231110_PREVIEW 和之後的版本。詳情請參閱存取預覽版 API。

建立評分量表。

這項要求必須由用來建立父項課程工作項目的 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
重要事項：指定 sourceSpreadsheetId 需要額外範圍時，才能透過 Google 試算表建立評分量表：https://www.googleapis.com/auth/spreadsheets.readonly 或 https://www.googleapis.com/auth/spreadsheets。請注意，spreadsheets 範圍屬於敏感範圍，因此您的應用程式可能需要經過驗證。

詳情請參閱授權指南。