此页面由 Cloud Translation API 翻译。

排查 Reseller API 问题

本页介绍了您在使用 Reseller API 时可能会遇到的一些常见问题。

`400:badRequest`

当订阅处于中止或取消状态时，会发生此错误。如需了解详情，请参阅激活订阅。

此错误可能是由多种原因造成的。

如果您使用的是 customers.insert 方法，则以下某个客户对象参数无效：

如需解决此问题，请验证必需参数是否存在且对客户有效。

如果您使用的是 subscriptions.changeSeats 方法，则以下问题之一可能导致了此错误：

您无法减少包年套餐类型的席位。考虑更改续订设置。在续订时自动将许可数量设置为等于账号中的活跃用户数量。
您申请的席位数少于账号中的当前用户数。向客户发送消息，告知他们必须先移除用户，然后才能减少席位数。
您增加了错误的座位参数。对于 FLEX 方案，增加 maximumNumberOfSeats 参数；对于 ANNUAL 方案，增加 numberOfSeats 参数。
您尝试更改 licensedNumberOfSeats 参数，但该参数是只读参数。
在试用期内，客户的席位上限为 10 个。从免费试用订阅开始付费服务，以立即结束试用期、开始结算并移除 10 个席位的上限。

如果您不是客户的所有者，或者您的客户已停用转销商对其管理控制台的访问权限，就会发生此错误。

当您达到此 API 的每日调用配额时，就会出现此错误。如需解决此问题，请实现退避延迟。如需了解详情，请参阅用量限额和配额。

如果您尝试检索大量订阅，请考虑使用不指定 customerId 或 subscriptionId 参数的 subscriptions.list 方法。每次调用最多可返回 100 个订阅。使用 pageToken 参数继续检索转销商账号下的所有订阅。

如果 Google Cloud 项目中未启用 API，则会发生此错误。如需解决此问题，请前往 Google Cloud 控制台，然后启用该 API。如需了解详情，请参阅启用 Google Workspace API。

使用 customers.get 方法时，此错误表示客户或网域不存在于任何 Google Workspace 账号中，并且该网域可用。

此错误是由多种不同的问题造成的。

如果您在使用 subscriptions.changeRenewalSettings 方法时遇到此错误，请确保您仅针对以下承诺付款方案调用此方法：

如果您在使用 subscriptions.delete 方法时遇到此错误，则表示 Google Workspace 账号中没有管理员用户。如需解决此问题，请添加临时管理员用户，然后重试。

如果您在使用 subscriptions.insert 方法时遇到此错误，则表示您无法将所选 SKU 转售给新兴市场客户。如需解决此问题，请接受适用的服务条款。

当您超出每秒查询次数限制时，会发生此错误。如需解决此问题，请实现退避重试策略或缓存结果，以减少 API 调用次数。如需了解详情，请参阅用量限额和配额。