限额和配额可保护 Google 的基础架构免受自动流程以不当方式使用 Reseller API 所造成的影响。请求过多可能是由于拼写错误或系统设计低效所致。为帮助确保 Google Workspace 系统的健康运行，Google 会在来自特定来源的流量达到一定级别时阻止该流量。这样可确保一个开发者的行为不会对社区造成负面影响。
API 请求失败
如果 API 请求失败，您的应用会收到一个 HTTP 状态代码。403 状态代码表示输入有误，503 状态代码表示已超出 API 配额。您可以使用这些响应来检测错误并采取相应措施。
基于时间的错误
对于基于时间的错误（尤其是 503 状态代码），请使用指数退避算法。等待一小段时间，然后再重试失败的调用。例如，等待 5 秒钟，然后重试。如果成功，请针对其他线程重复此模式。如果第二次请求失败，请减少请求频率，直到调用成功为止。建议确定重试次数上限，例如 5 到 7 次。
限制
| API 限额类别 | 限制 |
|---|---|
订阅 purchaseOrderId |
此属性最多可接受 80 个纯文本字符。 |
订阅 maxResults |
maxResults 搜索查询字符串可以包含 1 到 100 个结果。
默认值为 20 个结果。
|
转移令牌 (customerAuthToken) |
客户的转移令牌在生成后 30 天内有效。 |
| 客户的用户人数上限 | 根据您的合同，用户数上限可以是 5 万，也可以是转销商合同中规定的上限。 |
| 未经授权的请求 | Google 不允许向 Reseller API 发送未经授权的请求。如果未提供授权令牌，则请求未经授权。如需了解详情，请参阅了解身份验证和授权。 |
其他类型的限制
| 其他类型的限制 | 限制和准则 |
|---|---|
| 数据格式 |
数据格式为 JavaScript 对象表示法 (JSON)。
JSON 是一种常见的互联网格式，用于表示任意数据结构。它是一种与语言无关的文本格式，采用 C 系列语言（包括 C、C++、C#、Java、JavaScript、Perl 和 Python）程序员熟悉的惯例。 |
| 时间格式 | 日期和时间采用以毫秒为单位的 Epoch 转换器。此格式适用于订阅创建时间、方案承诺开始和结束时间以及免费试用结束时间。 |