限额和配额可保护 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 天内有效。 |
| 客户的用户人数上限 | 根据您的合同，用户数上限可以是 5 万，也可以是经销商合同中规定的上限。 |
| 未经授权的请求 | Google 不允许向 Reseller API 发送未经授权的请求。 如果未提供授权令牌，则相应请求会被视为未经授权。如需了解详情，请参阅了解身份验证和授权。 |
其他类型的限制
| 其他类型的限制 | 限制和准则 |
|---|---|
| 数据格式 |
数据格式为 JavaScript 对象表示法 JSON。
JSON 是一种常见的互联网格式，可用于表示任意数据结构。JSON 是一种完全独立于语言的文本格式，但它使用的惯例对于 C 系列语言（包括 C、C++、C#、Java、JavaScript、Perl 和 Python）的程序员来说非常熟悉。 |
| 时间格式 | 所有日期时间均以毫秒为单位，采用纪元转换器。此格式适用于订阅创建时间、方案的承诺开始时间和结束时间以及 30 天免费试用期的结束时间的值。 |