用户资格条件

虽然任何开发者都可以向 Google Classroom API 发出请求，但某些 Google Classroom 功能仅适用于特定用户。每项功能可能有不同的要求，例如需要拥有特定类型的 Google Workspace 教育版许可。 如需详细了解各个 Google Workspace 教育版许可级别的功能，请参阅版本对比页面。

关键术语：有资格的用户如果满足特定 Google 课堂功能的要求，则能够使用该功能。

要点：每位用户的能力是单独确定的，并且可能会随时间而变化。Classroom API 某些功能的功能资格条件可能与 Google 课堂应用中的相应功能不同。例如，使用该 API 创建、修改或删除评分标准时，需要满足某些许可要求。

有资格要求的功能

以下 Classroom API 功能仅适用于符合条件的用户：

• 创建和修改 Google 课堂插件附件。
• 修改评分周期设置。
• 创建、修改和删除评分标准。

确定用户功能

对 Classroom API 的请求是代表个人用户发出的。因此，在发出具有资格要求的 API 请求之前，您应检查用户是否具备相应的功能。

要点： 请考虑主动检查用户的功能，以便根据用户可访问的 Google 课堂功能调整产品的外观或行为。

如需确定用户是否具有特定功能，请向 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 课堂功能，但并不意味着特定请求一定会成功。