限制和配额

限制和配额可保护 Google 的基础架构，防止被自动化流程以不当方式使用 Reports API。从某个 API 发出过多请求的原因可能是无害的拼写错误，也可能是由于系统设计效率低下、进行不必要的 API 调用造成的。无论是什么原因，在来自特定来源的流量达到特定水平时，都有必要将其屏蔽，以保证 Google Workspace 系统的整体运行状况。它可确保一个开发者的行为不会对更广泛的社区产生负面影响。

万一您的 API 请求失败，您会收到 HTTP 状态代码响应。状态代码 403 包含有关输入不正确的错误信息，而 HTTP 状态代码 503 则包含指示已超出哪些 API 配额的错误信息。通过这些响应，您的自定义应用将能够检测这些错误并采取适当的措施。

如果您的请求需要在固定的时间段内完成，请并行发送请求，或在 Java 或 C# 应用中使用多个线程。并行请求的一个示例是请求来自不同用户的小批量电子邮件，而不是同时添加或移除一个用户中的大量电子邮件。对于会话，请尝试先创建 10 个会话，每个用户电子邮件地址对应一个会话。请注意，线程建议需要权衡取舍，并且并非适用于所有 API 情况。如果请求数过高，将会发生配额错误。

对于所有基于时间的错误（每个线程最多持续 N 秒 N 秒），尤其是 503 状态代码错误，我们建议您的代码捕获异常，并使用指数退避算法算法等待一小段延迟，然后再重试失败的调用。一个线程的 Reports API 示例是等待 5 秒钟，然后重试失败的调用。如果请求成功，请对其他线程重复此模式。如果第二个请求未成功，您的应用应根据请求频率缩容，直到调用成功为止。例如，将初始的 5 秒延迟增加到 10 秒，然后再次重试失败的呼叫。此外，您需要决定重试次数上限。例如，在您的应用向用户返回错误之前，使用不同的延迟时间重试请求 5 到 7 次。