排查 Reseller API 问题

这一页介绍了您可能会遇到的一些涉及到 Reseller API。

400:badRequest

当订阅被暂停或取消时,就会发生此错误。对于 请参阅 激活订阅

400:invalid

导致此错误的原因有很多。

如果您使用的是 customers.insert 方法,则须满足以下条件之一: 对象参数无效:

  • postalAddress.postalCode无效。
  • postalAddress.countryCode 不符合转销 Google Workspace 的条件。
  • alternateEmail 不能与 customerDomain 位于同一网域

要解决此问题,请确认必需的参数存在且适用于 客户。

如果您使用的是 subscriptions.changeSeats 方法,请使用以下某个值: 个问题可能造成了此错误:

  • 对于包年套餐类型,您无法减少席位数。考虑 更改续订设置。 让订阅自动设置(在续订时)席位等于 调整为相应账号的活跃用户数量。
  • 您申请的席位数量少于 。告知客户,必须先移除用户,然后才能移除 减少席位数。
  • 您增加了错误的座位参数。对于 FLEX 方案,增加 使用 maximumNumberOfSeats 参数;对于 ANNUAL 方案,请增加 numberOfSeats 参数。
  • 您试图更改 licensedNumberOfSeats 参数,该参数 只读参数。
  • 在试用期内,客户的席位上限为 10 个。 从免费试用订阅开始一项付费服务 立即结束试用期、开始计费并移除 10 位用户 上限。

403:forbidden

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

403:usageLimits.dailyLimitExceeded

达到此 API 的每日调用配额时,就会出现此错误。接收者 请实施退避延迟时间如需了解详情,请参阅 用量限额和配额

如果您要检索多个订阅,请考虑使用 subscriptions.list 方法,而不指定 customerIdsubscriptionId 参数。您最多可返回 100 个订阅 调用。使用 pageToken 参数继续检索所有订阅 您在一个转销商账号下

403:usageLimits.accessNotConfigured

如果 Google Cloud 项目中未启用该 API,就会出现此错误。要解决 请前往 Google Cloud 控制台启用 API。有关 请参阅 启用 Google Workspace API

404:notFound

使用 customers.get 方法时,此错误意味着客户或 域名不存在,并且该域名 域名可用。

412:conditionNotMet

此错误是由许多不同问题引起的。

如果您在使用 subscriptions.changeRenewalSettings 时遇到此错误 方法,请确保您只对以下 承诺付款方案:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

如果您在使用 subscriptions.delete 方法时遇到此错误, 则意味着 Google Workspace 上不存在管理员用户 。要解决此问题,请添加临时管理员用户,然后重试。

如果您在使用 subscriptions.insert 方法时遇到此错误, 意味着您无法转售所选的 SKU 或向新兴市场进行转售 客户。要解决此问题,请接受适用的服务条款。

429:usageLimits.quotaExceeded

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

如果您要检索多个订阅,请考虑使用 subscriptions.list 方法,而不指定 customerIdsubscriptionId 参数。您最多可返回 100 个订阅 调用。使用 pageToken 参数继续检索所有订阅 您在一个转销商账号下