虽然任何开发者都可以向 Google Classroom API 发出请求,但某些 Google Classroom 功能仅适用于特定用户。每项功能可能都有不同的要求,例如需要拥有特定的 Google Workspace 教育版许可类型。如需详细了解各个 Google Workspace 教育版许可级别提供的功能,请参阅版本对比页面。
具有资格要求的功能
以下 Classroom API 功能仅适用于符合条件的用户:
确定用户功能
对 Classroom API 的请求是代表个人用户发出的。因此,您应先检查用户是否具有适当的功能,然后再发出具有资格要求的 API 请求。
如需确定用户是否具有特定 capability,请向 checkUserCapability
方法发出 API 请求。为您打算使用的 Google 课堂功能添加适当的 Capability
类型。为每个功能指定适当的 Capability
:
如需了解用户是否… | Capability |
---|---|
有权访问请求 Google Cloud 项目拥有的 Google 课堂插件 | CREATE_ADD_ON_ATTACHMENT |
可以修改评分周期设置 | UPDATE_GRADING_PERIOD_SETTINGS |
可以创建或修改评分准则 | CREATE_RUBRIC |
接下来,检查响应中的 allowed
字段。如果 allowed
为 true
,则用户有权访问所选的 Capability
。然后,您可以代表用户发出与 Capability
相关的 API 请求。