本页介绍了您在使用 Reseller API 时可能会遇到的一些常见问题。
400:badRequest
当订阅被暂停或取消时,会发生此错误。如需了解详情,请参阅激活订阅。
400:invalid
此错误可能是由多种原因造成的。
如果您使用的是 customers.insert 方法,则以下某个客户对象参数无效:
postalAddress.postalCode无效。- 不符合转售 Google Workspace 的条件。
postalAddress.countryCode alternateEmail不能与customerDomain位于同一网域
如需解决此问题,请验证必需参数是否存在且对客户有效。
如果您使用的是 subscriptions.changeSeats 方法,则以下问题之一可能导致了此错误:
- 您无法减少包年套餐类型的席位。考虑更改续订设置。 在续订时自动将许可数量设置为账号中的活跃用户数量。
- 您申请的席位数少于账号中的当前用户数。向客户发送消息,告知他们必须先移除用户,然后才能减少席位数。
- 您增加了错误的座位参数。对于
FLEX方案,请增加maximumNumberOfSeats参数;对于ANNUAL方案,请增加numberOfSeats参数。 - 您尝试更改
licensedNumberOfSeats参数,但该参数是只读参数。 - 在试用期内,客户的席位上限为 10 个。 从免费试用订阅开始付费服务,以立即结束试用期、开始结算并移除 10 个席位的上限。
403:forbidden
如果您不是客户的所有者,或者您的客户已停用转销商对其管理控制台的访问权限,就会发生此错误。
403:usageLimits.dailyLimitExceeded
当您达到此 API 的每日调用配额时,就会出现此错误。如需解决此问题,请实现退避延迟。如需了解详情,请参阅用量限额和配额。
如果您尝试检索大量订阅,请考虑使用不指定 customerId 或 subscriptionId 参数的 subscriptions.list 方法。每次调用最多可返回 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_PAYANNUAL_YEARLY_PAY
如果您在使用 subscriptions.delete 方法时遇到此错误,则表示 Google Workspace 账号中没有管理员用户。如需解决此问题,请添加临时管理员用户,然后重试。
如果您在使用 subscriptions.insert 方法时遇到此错误,则表示您无法将所选 SKU 转售给新兴市场客户。如需解决此问题,请接受适用的服务条款。
429:usageLimits.quotaExceeded
当您超出每秒查询次数限制时,会发生此错误。如需解决此问题,请实现退避重试策略或缓存结果,以减少 API 调用次数。如需了解详情,请参阅用量限额和配额。
如果您尝试检索大量订阅,请考虑使用不指定 customerId 或 subscriptionId 参数的 subscriptions.list 方法。每次调用最多可返回 100 个订阅。使用 pageToken 参数继续检索转销商账号下的所有订阅。