Google Classroom 外掛程式現已全面開放開發人員使用!詳情請參閱
外掛程式說明文件 。
提供意見
使用者資格
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
雖然任何開發人員都可以向 Google Classroom API 提出要求,但某些 Google Classroom 功能僅供特定使用者使用。每項功能可能都有不同的規定,例如需要特定的 Google Workspace for Education 授權類型。如要進一步瞭解各個 Google Workspace for Education 授權層級的功能,請參閱版本比較頁面 。
關鍵字: 符合資格 的使用者在符合功能規定的情況下,有使用權限 使用特定 Classroom 功能。重點: 每位使用者的使用權限各不相同,且可能隨時間變動。Classroom API 部分功能的功能資格可能與 Google Classroom 應用程式中的對應功能不同。舉例來說,使用 API 建立、修改或刪除評量標準時,必須符合特定授權要求 。 設有資格規定的功能
下列 Classroom API 功能僅供符合資格的使用者使用:
判斷使用者功能
向 Classroom API 提出的要求是代表個別使用者提出。因此,您應先檢查使用者是否具備適當的功能,再發出符合資格的 API 要求。
重點: 建議您主動檢查使用者功能,以便根據使用者可存取的 Classroom 功能,調整產品的外觀或行為。
如要判斷使用者是否具備特定功能,請對 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 要求。
重要事項: 即使使用者符合資格,API 要求仍可能因資格問題而失敗。符合資格表示使用者可以使用 Classroom 功能,並非特定要求一定會成功。
提供意見
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權 ,程式碼範例則為阿帕契 2.0 授權 。詳情請參閱《Google Developers 網站政策 》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-04-16 (世界標準時間)。
想進一步說明嗎?
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-04-16 (世界標準時間)。"],[],[]]