雖然任何開發人員都可以向 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 |
---|---|
可建立或修改 Classroom 外掛程式附件,且該附件與用於提出要求的 OAuth 用戶端 ID 相關聯的 Google Cloud 專案 | CREATE_ADD_ON_ATTACHMENT |
可以修改評分期間設定 | UPDATE_GRADING_PERIOD_SETTINGS |
可建立、修改或刪除評分量表 | CREATE_RUBRIC |
接著,請查看回應中的 allowed
欄位。如果 allowed
是 true
,則使用者可以存取所選的 Capability
。接著,您可以代表使用者提出與 Capability
相關的 API 要求。