虽然任何开发者都可以向 Google Classroom API 发出请求,但某些 Google Classroom 功能仅适用于特定用户。每项功能可能都有不同的要求,例如需要拥有特定的 Google Workspace 教育版许可类型。如需详细了解各个 Google Workspace 教育版许可级别的功能,请参阅版本对比页面。
具有资格要求的功能
以下 Classroom API 功能仅适用于符合条件的用户:
- 创建和修改 Google 课堂插件附件。
- 修改评分周期设置。
- 创建、修改和删除评分标准。
确定用户功能
对 Classroom API 的请求是代表个人用户发出的。因此,您应先检查用户是否具有适当的功能,然后再发出具有资格要求的 API 请求。
如需确定用户是否具有特定 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 请求。