Google Classroom 外掛程式現已全面開放開發人員使用!詳情請參閱
外掛程式說明文件。
Method: courses.updateGradingPeriodSettings
更新課程的評分期間設定。提出要求的使用者和課程擁有者必須符合修改「評分期間」的資格。詳情請參閱授權需求條件。
這個方法會傳回下列錯誤代碼:
- 如果要求的使用者無法修改課程的評分期間設定或存取錯誤,請
PERMISSION_DENIED
:
- UserIneligibleToUpdateGradingPeriodSettings
- 如果要求格式錯誤,則為
INVALID_ARGUMENT
。
- 如果要求的課程不存在,則為
NOT_FOUND
。
HTTP 要求
PATCH https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
courseId |
string
必要欄位。課程的 ID。
|
查詢參數
參數 |
updateMask |
string (FieldMask format)
這個遮罩可識別 GradingPeriodSettings 中要更新的欄位。 GradingPeriodSettings gradingPeriods 清單會完全替換為更新要求中指定的評分期間。例如:
- 系統會將清單中不含 ID 的評分期間視為新增的,並會在提出要求時指派新的 ID。
- 目前已存在但要求中缺少的評分期間,則會視為刪除。
- 系統會將含有現有 ID 和經過修改資料的評分期間視為編輯。未修改的資料會維持不變。
- 使用不明 ID 的評分期間會導致錯誤。
以下是可指定的欄位:
gradingPeriods
applyToExistingCoursework
這是以半形逗號分隔的完整欄位名稱清單。範例:"user.displayName,photo" 。
|
previewVersion |
enum (PreviewVersion )
選用設定。API 的預先發布版。完成這項設定後,才能存取搶先體驗方案為開發人員提供的全新 API 功能。
|
回應主體
如果成功,回應主體會包含 GradingPeriodSettings
的執行例項。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/classroom.courses
詳情請參閱授權指南。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-02-27 (世界標準時間)。
[null,null,["上次更新時間:2025-02-27 (世界標準時間)。"],[[["Updates a course's grading period settings, requiring eligibility to modify them by both the requesting user and course owner."],["The request must include a field mask to specify which fields of the GradingPeriodSettings are to be updated, potentially adding, deleting, or editing grading periods."],["The API uses a PATCH request to `https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings`, where `{courseId}` is replaced with the specific course identifier."],["Potential errors include `PERMISSION_DENIED`, `INVALID_ARGUMENT`, and `NOT_FOUND` based on user permissions, request validity, and course existence."],["Authorization requires the `https://www.googleapis.com/auth/classroom.courses` OAuth scope."]]],[]]