用量限额和配额

限制和配额可保护 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 次。