任何開發人員都可以向 Google Classroom API 發出要求,但部分 Google Classroom 功能僅供特定使用者使用。各項功能可能會有不同規定,例如必須具備特定類型的 Google Workspace for Education 授權。如要詳細瞭解各個 Google Workspace for Education 授權層級的功能,請參閱版本比較頁面。
有資格規定的功能
下列 Classroom API 功能僅適用於符合資格的使用者:
- 建立及修改 Classroom 外掛程式附件。
- 修改評分期間設定。
- 建立、修改及刪除評量規準。
判斷使用者功能
系統會代表個別使用者向 Classroom API 提出要求。因此,在發出有資格條件的 API 要求前,請先檢查使用者是否具備適當功能。
如要判斷使用者是否具備特定功能,請對 checkUserCapability
方法提出 API 要求。請為您要使用的 Classroom 功能加入適當的 Capability
類型。為每項功能指定適當的 Capability
:
如要查看使用者是否... | Capability |
---|---|
建立或修改與 Google Cloud 專案相關聯的 Classroom 外掛程式附件,該專案的 OAuth 用戶端 ID 用於提出要求 | CREATE_ADD_ON_ATTACHMENT |
可以修改評分週期設定 | UPDATE_GRADING_PERIOD_SETTINGS |
可以建立、修改或刪除評分量表 | CREATE_RUBRIC |
接著,請檢查回應中的 allowed
欄位。如果 allowed
為 true
,則使用者有權存取所選 Capability
。然後代表使用者提出與 Capability
相關的 API 要求。