Google 课堂插件现已面向开发者正式推出!如需了解详情,请参阅
插件文档 。
发送反馈
用户资格条件
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
虽然任何开发者都可以向 Google Classroom API 发出请求,但某些 Google Classroom 功能仅适用于特定用户。每项功能可能有不同的要求,例如需要拥有特定类型的 Google Workspace 教育版许可。
如需详细了解各个 Google Workspace 教育版许可级别的功能,请参阅版本对比页面 。
关键术语 :有资格 的用户如果满足特定 Google 课堂功能的要求,则能够 使用该功能。要点 :每位用户的能力是单独确定的,并且可能会随时间而变化。Classroom API 某些功能的功能资格条件可能与 Google 课堂应用中的相应功能不同。例如,使用该 API 创建、修改或删除评分标准时,需要满足某些许可要求 。
有资格要求的功能
以下 Classroom API 功能仅适用于符合条件的用户:
确定用户功能
对 Classroom API 的请求是代表个人用户发出的。因此,在发出具有资格要求的 API 请求之前,您应检查用户是否具备相应的功能。
要点 : 请考虑主动检查用户的功能,以便根据用户可访问的 Google 课堂功能调整产品的外观或行为。
如需确定用户是否具有特定功能,请向 checkUserCapability
方法发出 API 请求。针对您打算使用的 Google 课堂功能,添加相应的 Capability
类型。为每项功能指定适当的 Capability
:
查看用户是否...
Capability
可以创建 或修改 与用于发出请求的 OAuth 客户端 ID 的 Google Cloud 项目关联的 Google 课堂插件附件
CREATE_ADD_ON_ATTACHMENT
可以修改 评分周期设置
UPDATE_GRADING_PERIOD_SETTINGS
可以创建 、修改 或删除 评分准则
CREATE_RUBRIC
接下来,检查响应中的 allowed
字段。如果 allowed
为 true
,则用户有权访问所选的 Capability
。然后,您可以代表用户发出与 Capability
相关的 API 请求。
重要提示 : 即使用户符合条件,依赖于资格条件的 API 请求仍有可能失败。符合条件意味着用户可以使用 Google 课堂功能,但并不意味着特定请求一定会成功。
发送反馈
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可 获得了许可,并且代码示例已根据 Apache 2.0 许可 获得了许可。有关详情,请参阅 Google 开发者网站政策 。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):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"]],["最后更新时间 (UTC):2025-08-01。"],[],[],null,[]]