使用者資格

任何開發人員都可以向 Google Classroom API 發出要求，但部分 Google Classroom 功能僅供特定使用者使用。各項功能可能會有不同規定，例如必須具備特定類型的 Google Workspace for Education 授權。如要詳細瞭解各個 Google Workspace for Education 授權層級的功能，請參閱版本比較頁面。

重要字詞：符合資格的使用者只要符合功能需求，就能使用特定 Classroom 功能。

重點：系統會為每位使用者分別判斷功能使用資格，且資格可能會隨時間變更。Classroom API 部分功能的適用資格，可能與 Google Classroom 應用程式中的對應功能不同。舉例來說，透過 API 建立、修改或刪除評量表時，須符合特定授權規定。

有資格規定的功能

下列 Classroom API 功能僅適用於符合資格的使用者：

• 建立及修改 Classroom 外掛程式附件。
• 修改評分期間設定。
• 建立、修改及刪除評量規準。

判斷使用者功能

系統會代表個別使用者向 Classroom API 提出要求。因此，在發出有資格條件的 API 要求前，請先檢查使用者是否具備適當功能。

重點提示： 建議您主動檢查使用者功能，以便調整產品外觀或行為，配合使用者可存取的 Classroom 功能。

如要判斷使用者是否具備特定功能，請對 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 要求。

重要事項： 即使使用者符合資格，依據資格條件提出的 API 要求仍可能失敗。資格是指使用者可以運用 Classroom 功能，而非特定要求會成功。