用量限额和配额

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

API 请求失败

在极少数情况下，如果您的 API 请求失败，您的应用会收到 HTTP 状态代码响应。状态代码 403 包含有关错误输入的错误信息，而 HTTP 状态代码 503 包含指示超出了哪些 API 配额的错误信息。通过这些响应，您的自定义应用可以检测这些错误并采取适当的措施。

基于时间的错误

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

限制

API 限制类别	限制
订阅日期：purchaseOrderId	此属性最多可接受 80 个纯文本字符。
订阅日期：maxResults	maxResults 查询字符串可以是 1 - 100 个结果。默认值为 20 个结果。
转移令牌 (customerAuthToken)	客户的转移令牌在生成后 30 天内有效。
客户的用户人数上限	用户人数上限可以是 50,000，也可以是转销商合同中指定的上限，具体取决于您的合同。
未经授权的请求	Google 不允许向 Reseller API 发出未经授权的请求。 如果未提供授权令牌，请求会被视为未授权。如需了解详情，请参阅了解身份验证和授权。

其他类型的限制

其他类型的限制	限制和准则
数据格式	数据格式采用 JavaScript 对象表示法 JSON。 JSON 是一种常见的互联网格式，它提供了一种表示任意数据结构的方法。JSON 是一种完全独立于语言的文本格式，但使用的是 C 语言系列（包括 C、C++、C#、Java、JavaScript、Perl 和 Python）的编程人员所熟悉的惯例。
时间格式	所有日期时间均采用纪元转换器（以毫秒为单位）。此格式适用于订阅创建时间、方案承诺的开始时间和结束时间以及 30 天免费试用结束时间的值。