Google Classroom 外掛程式現已全面開放開發人員使用!詳情請參閱
外掛程式說明文件。
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
的執行例項。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/classroom.coursework.students
詳情請參閱授權指南。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-04 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2024-09-04 (世界標準時間)。"],[],[]]