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