使用限制

系统会按 60 秒的移动平均值检查配额,允许使用量出现峰值。默认情况下,Classroom API 受下表中限制的约束:

限制 配额标准
每个客户端每天的查询次数 4,000,000(平均 46 QPS)
每位客户每分钟的查询次数 3,000 (50 QPS)
每个用户每分钟的查询次数 1,200 (20 QPS)

允许的 QPS 可能会增加或减少,具体取决于多种运营因素。

如果您需要发出的请求数量超出对您的项目应用的上限,请执行以下操作:

  1. 首先,确保通过重试请求(最好使用指数退避算法)来响应可重试的错误(例如,当请求超出限制时返回的 RESOURCE_EXHAUSTED 错误)。
  2. 如果您在提供此功能的端点上轮询更改,不妨改用推送通知
  3. 如果您需要发出的请求数量仍超出为项目分配的上限,请参阅下文,了解如何申请更高的上限。

如需查看或更改项目的用量限制,或申请增加配额,请按以下步骤操作:

  1. 如果您的项目还没有结算账号,请创建一个。
  2. 在 API 控制台中访问 API 库中的“已启用的 API”页面,然后从列表中选择一个 API。
  3. 如需查看和更改配额相关设置,请选择配额。如需查看用量统计信息,请选择使用量