這個方法會傳回下列錯誤代碼:
PERMISSION_DENIED
代表存取錯誤。- 如果要求格式錯誤,則為
INVALID_ARGUMENT
。 - 如果要求的課程不存在,則為
NOT_FOUND
。
HTTP 要求
GET https://classroom.googleapis.com/v1/courses/{courseId}:checkGradingPeriodsSetupEligibility
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
courseId |
必要欄位。課程的 ID。 |
查詢參數
參數 | |
---|---|
previewVersion |
選用設定。API 的預先發布版。完成這項設定後,才能存取搶先體驗方案為開發人員提供的全新 API 功能。 |
要求主體
要求主體必須為空白。
回應主體
是否允許使用者更新本課程中的 GradingPeriodSettings 更新關係。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
---|
{
"courseId": string,
"isGradingPeriodsSetupEligible": boolean,
"previewVersion": enum ( |
欄位 | |
---|---|
courseId |
不可變動。課程的 ID。 |
isGradingPeriodsSetupEligible |
是否允許使用者更新本課程中的 GradingPeriodSettings 設定。 |
previewVersion |
僅供輸出。API 的預先發布版。完成這項設定後,才能存取搶先體驗方案為開發人員提供的全新 API 功能。 |
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/classroom.courses
https://www.googleapis.com/auth/classroom.courses.readonly
詳情請參閱授權指南。