用量限额和配额

限制和配额可保护 Google 基础架构免受自动流程以不当方式使用 Alert Center API 所造成的影响。来自 API 的请求过多可能是由于无害的拼写错误所致,也可能是由于低效系统对 API 进行不必要的调用所致。无论是何种原因,都有必要在来自特定来源的流量达到某一级别时阻止该流量,以确保 Google Workspace 系统总体运行状况良好。这有助于确保一个开发者的行为所造成的负面影响不会波及更大范围的开发者群体。

在极少数情况下,您的 API 请求会失败,此时您会收到 HTTP 状态代码响应。状态代码 403 包含有关输入不正确的错误信息,而 HTTP 状态代码 503 包含错误信息,指明哪些 API 配额已超出。通过这些响应,您的自定义应用可以检测到这些错误并采取适当的操作。

如果您的请求需要在固定的时间段内完成,请并行发送请求,或在 Java 或 C# 应用中使用多个线程。并行请求的一个示例是请求来自不同用户的少量电子邮件,而不是同时添加或移除来自一个用户的大量电子邮件。对于线程,请尝试从 10 个线程开始,每个用户电子邮件对应一个线程。请注意,线程建议有利有弊,并非适用于所有 API 情况。如果请求数量过高,则会发生配额错误。

对于所有基于时间的错误(每个线程每 N 秒最多 N 个内容),尤其是 503 状态代码错误,我们建议您的代码捕获异常,并使用指数退避算法等待一小段时间,然后再重试失败的调用。对于一个线程,Alert Center API 示例是等待 5 秒,然后重试失败的调用。如果请求成功,请对其他线程重复此模式。如果第二个请求不成功,您的应用应减少请求的频率,直到调用成功为止。例如,将初始 5 秒的延迟时间增加到 10 秒,然后再次重试失败的调用。此外,还要确定重试限制。例如,在应用向用户返回错误之前,使用不同的延迟时间重试请求 5 到 7 次。

API 限制类别 限制
提醒中心 QPS 和 QPD 速率 该 API 限制了 Google Cloud 项目的请求数量。API 项目的每秒请求数上限(项目 QPS) 为 1000。并且,每个用户每秒的请求数上限 (用户 QPS)为 150。

如果超出这些限制,服务器会返回 HTTP 503 状态代码。重试请求时,请使用 指数 退避算法。

其他类型的限制 限制和准则
数据格式,默认 默认数据格式为 JSON。
未经授权的请求 Google 不允许向此 API 发送未经授权的请求。如果未提供授权令牌,则请求 会被视为未经授权。如需了解详情,请参阅授权请求

申请提高每个项目的配额

根据项目的资源用量,您可能需要申请调整配额。服务账号的 API 调用会被视为使用单个账号。我们无法保证您的配额调整申请一定会得到批准。对于会大幅增加配额值的配额调整申请,可能需要更长时间才能获得批准。

并非所有项目的配额都完全相同。当 Google Cloud 使用量随着时间推移逐步增加时,您的配额值可能需要增加。如果您预计自己的用量即将显著增加,可以在 Google Cloud 控制台的“配额和系统限制”页面中提前申请调整配额。

如需了解详情,请参阅以下资源: