配额和限制

Merchant API 功能具有严格的配额和限制。

更新政策

Merchant API 在更新方面会强制执行以下政策:

  • 您每天最多只能更新商品两次。
  • 您每天只能更新一次子账号。

方法调用配额

Merchant API 会根据您的使用情况,自动调整 productsaccounts 的调用配额。

我们会通过以下方式跟踪您的配额使用情况:

  • 配额以每个方法为单位。例如,get 方法和 update 方法的配额是分别独立的。
  • 无论请求类型如何,每个请求都会统计一次。例如,我们会将包含 250 个项的 list 请求计为 1 次,而不是 250 次 get 请求。
  • 配额适用于您在发出调用时对其进行身份验证的购物比较服务 (CSS) 组、CSS、账号或子账号。例如,如果您以高级账号身份进行身份验证,则调用次数会计入高级账号的配额;但如果您以某个子账号的身份进行身份验证,则调用次数会计入该子账号的配额。

该图显示了 CSS 组、CSS、账号和子账号的层次结构。 图片显示,CSS 组是总体身份验证级别,其中可能包含各个 CSS,这些 CSS 中的账号和子账号是最低级别。

查看您的配额

如需查看账号的当前配额和用量,请使用账号的 name 调用 quotas.list

自动配额仅适用于 productsaccounts 服务。如果您需要为任何其他服务增加配额、达到了 productsaccounts 服务的每日配额,或者需要为 accounts 或产品 services 暂时增加配额,请与我们联系,并提供以下信息:

  • 您的 Merchant Center ID
  • 已达到配额上限的方法
  • 您每天需要对这些方法进行的调用次数的估算值
  • 您需要增加配额的原因
  • 是临时增加还是永久增加

我们建议您定期检查配额,确保您有足够的配额来实现您的功能,或者了解配额的自动调整方式。

错误

如果超出配额,您会收到以下错误:

  • 每分钟:quota/request_rate_too_high
  • 每天:quota/daily_limit_exceeded

如需查看配额和用量,以及申请增加每日配额或按分钟配额,请参阅查看配额

以下错误无法通过自动增加配额来解决,您需要申请增加商品、Feed 或子账号的配额

  • too_many_items: Merchant quota exceeded
  • too_many_subaccounts: Maximum number of sub-accounts reached

资源表示法限制

以下限制介绍了 Merchant API 中所用的资源表示法中某些字符串值和数组字段的明显的限制。对于 Merchant API 及其在 Merchant Center 中的相应功能而言,这些限制都相同。

请注意,此限制列表可能不完整。我们不会延长这些限制。

资源 字段 限制
shippingsettings

每个国家/地区的配送服务数 (services)。

每个配送服务的配送组数 (rateGroups)。

每个配送组的标签数 (applicableShippingLabels)。

每个配送组的子表数 (subtables)。

单个费率表中的行数或列数。

配送标签的长度。

20

20

30

100

150

100

费率表中的行数或列数会影响以下数组字段

  • rowHeaderscolumnHeaders 中的数组字段:
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]