排查 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 方法时,此错误表示客户或网域不存在于任何 Google Workspace 账号中,并且该网域可用。

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 参数继续检索转销商账号下的所有订阅。