用量限额和配额

限制和配额可保护 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 次，每次重试的延迟时间各不相同。