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

必要欄位。課程的 ID。
courseWorkId

string

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

string

選用設定。評分量表的 ID。

查詢參數

參數
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

詳情請參閱授權指南。