针对 Content API for Shopping 的限制

Content API for Shopping 对某些功能强加了配额和硬性限制。下面显示的配额和限制仅用于帮助您开发使用 Content API for Shopping 的应用。Google 有权随时取消、减少或更改所有配额和限制,恕不另行通知。

HTTP 请求限制

Content API for Shopping 端点限制为每秒执行 300 次查询 (QPS)。此限制是针对每个 Google API 控制台项目,而非每个 Merchant Center 帐号。由于此限制针对 HTTP 请求,而非方法调用,因此对于这种特定的限制来说,包含多个方法调用的 custombatch 调用将仅计为一次查询。超过 QPS 限制时,用户将收到 userRateLimitExceeded 错误。

方法调用配额

以下限制是 Merchant Center 帐号的默认方法调用配额。

  • 超过每分钟配额时,用户将收到 quota/request_rate_too_high 错误。
  • 超过每日配额时,用户将收到 quota/daily_limit_exceeded 错误。

如果此处列出的针对特定方法的配额不能满足您的要求,并需要申请更高的配额,请通过 Content API for Shopping 支持论坛与我们联系。

以下是一些注意事项:

  • 此处所指的配额是针对方法的。例如,get 方法和 update 方法的调用配额是分别独立的,虽然两个配额的大小相同。
  • 一种方法的空运行(即,使用 dryRun 查询参数)与正常运行分开计算。
  • 对于配额使用情况,patch 方法同时计算 get 调用和 update 调用。
  • custombatch 调用中的每个方法调用都将根据其特定配额单独计算。
服务 方法 每分钟配额 每日配额
Accounts authinfo 600 10000
所有其他方法 1000 10000
Accountstatuses 所有方法 1000 10000
Accounttax 所有方法 1000 10000
Datafeeds fetchnow 10 200
所有其他方法 500 10000
Datafeedstatuses 所有方法 500 10000
Inventory 所有方法 300000 500000000
Liasettings requestgmbaccess 500 500
setinventoryverificationcontact 500 500
requestinventoryverification 500 500
所有其他方法 1000 10000
Orders 所有方法 10000 1000000
Orders 沙盒 使用沙盒环境时的所有 Orders 方法 500 2000
Orderinvoices 所有方法 10000 1000000
Orderpayments 所有方法 10000 1000000
Orderreports 所有方法 10000 1000000
Orderreturns list(临时限制) 1 1000000
所有其他方法 10000 1000000
Pos 所有方法 5000 1000000
Products 所有方法 60000 20000000
Productstatuses 所有方法 60000 20000000
[Regionalinventory][] 所有方法 60000 20000000
Shippingsettings 所有方法 1000 10000

资源展示限制

以下限制介绍了 Content API 中所用的资源展示中某些字符串值和数组字段的明显的限制。对于 Content API 及其在 Merchant Center 中的相应功能而言,这些限制都相同。此限制列表可能不完整,并且无法扩展这些限制。

资源 字段 限制
Accounttax 税费规则数量 (rules[]) 100
Shippingsettings 每个国家/地区的配送服务数 (services[]) 20
每个配送服务的配送组数 (rateGroups[]) 20
每个配送组的标签数 (applicableShippingLabels[]) 30
每个配送组的子表数 (subtables[]) 100
单个费率表中的行数或列数2 150
配送标签的长度 100

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

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