本页面介绍了您可能会遇到的关于 Reseller API 的一些常见问题。
400:badRequest
当订阅被暂停或取消时,就会出现此错误。如需了解详情,请参阅激活订阅。
400:invalid
导致此错误的原因有很多。
如果您使用的是 customers.insert
方法,则以下某个客户对象参数无效:
postalAddress.postalCode
无效。postalAddress.countryCode
不符合转销 Google Workspace 的条件。alternateEmail
不能与customerDomain
位于同一网域
如需解决此问题,请验证必需参数是否存在,以及对客户有效。
如果您使用的是 subscriptions.changeSeats
方法,则可能是以下某个问题导致了此错误:
- 您无法减少包年套餐类型的席位。请考虑更改续订设置。为订阅自动设置(在续订时)席位,其数量等于账号的活跃用户数。
- 您申请的席位金额少于账号中当前的用户数。向客户发送消息,告知他们必须先移除用户,然后才能减少席位数量。
- 您增加了错误的 seat 参数。对于
FLEX
方案,请增加maximumNumberOfSeats
参数;对于ANNUAL
方案,请增加numberOfSeats
参数。 - 您尝试更改
licensedNumberOfSeats
参数,该参数为只读参数。 - 在试用期内,客户的席位上限为 10 个。 通过免费试用订阅启用付费服务以立即结束试用期、开始计费,并移除 10 个席位的上限。
403:forbidden
如果您不是客户的所有者,或者您的客户已禁止转销商访问其管理控制台,就会出现此错误。
403:usageLimits.dailyLimitExceeded
当达到此 API 调用的每日配额时,就会出现此错误。如需解决此问题,请实现退避延迟时间。如需了解详情,请参阅用量限额和配额。
如果您要尝试检索多个订阅,不妨考虑使用 subscriptions.list
方法,而不指定 customerId
或 subscriptionId
参数。每次调用最多可以返回 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
方法,而不指定 customerId
或 subscriptionId
参数。每次调用最多可以返回 100 个订阅。使用 pageToken
参数继续检索转销商帐号下的所有订阅。