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
建立 或修改 與 Google Cloud 專案相關聯的 Classroom 外掛程式附件,該專案的 OAuth 用戶端 ID 用於提出要求
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-08-01 (世界標準時間)。
想進一步說明嗎?
[[["容易理解","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-08-01 (世界標準時間)。"],[],[],null,[]]