Google 课堂插件现已面向开发者正式推出!如需了解详情,请参阅
插件文档 。
发送反馈
用户资格条件
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
虽然任何开发者都可以向 Google Classroom API 发出请求,但某些 Google Classroom 功能仅适用于特定用户。每项功能可能都有不同的要求,例如需要拥有特定的 Google Workspace 教育版许可类型。如需详细了解各个 Google Workspace 教育版许可级别提供的功能,请参阅版本对比页面 。
关键术语 :符合条件 的用户如果符合功能要求,则有能力 使用某项 Google 课堂功能。 要点 :系统会为每位用户单独确定功能使用权限,并且这些权限可能会随时间而变化。Classroom API 的某些功能的使用资格要求可能与 Google Classroom 应用中的相应功能不同。例如,使用该 API 创建、修改或删除评分标准时,需要满足特定的许可要求 。
具有资格要求的功能
以下 Classroom API 功能仅适用于符合条件的用户:
确定用户功能
对 Classroom API 的请求是代表个人用户发出的。因此,您应先检查用户是否具有适当的功能,然后再发出具有资格要求的 API 请求。
要点 :不妨考虑主动检查用户功能,以便根据用户可以访问的 Google 课堂功能,量身定制产品的外观或行为。
如需确定用户是否具有特定 capability,请向 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-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"]],["最后更新时间 (UTC):2025-04-16。"],[],[]]