用户资格条件

虽然任何开发者都可以向 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 字段。如果 allowedtrue,则用户有权访问所选的 Capability。然后,您可以代表用户发出与 Capability 相关的 API 请求。