限制和配额可保护 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 不允许向转销商 API 发出未经授权的请求。 如果未提供授权令牌，请求会被视为未经授权。如需了解详情，请参阅了解身份验证和授权。 |
其他类型的限制
| 其他类型的限制 | 限制和指南 |
|---|---|
| 数据格式 |
数据格式为 JavaScript 对象表示法 JSON。
JSON 是一种常见的互联网格式，可提供表示任意数据结构的方法。JSON 是一种完全与语言无关的文本格式，但使用了 C 语言族（包括 C、C++、C#、Java、JavaScript、Perl 和 Python）程序员熟悉的惯例。 |
| 时间格式 | 所有日期时间均采用纪元转换器，以毫秒为单位。此格式适用于订阅创建时间、方案的承诺期限开始时间和结束时间，以及 30 天免费试用的结束时间。 |