Merchant API 功能具有严格的配额和限制。
更新政策
Merchant API 在更新方面会强制执行以下政策:
- 您每天最多只能更新商品两次。
- 您每天只能更新一次子账号。
方法调用配额
Merchant API 会根据您的使用情况,自动调整 products
和 accounts
的调用配额。
我们会通过以下方式跟踪您的配额使用情况:
- 配额以每个方法为单位。例如,
get
方法和update
方法的配额是分别独立的。 - 无论请求类型如何,每个请求都会统计一次。例如,我们会将包含 250 个项的
list
请求计为 1 次,而不是 250 次get
请求。 - 配额适用于您在发出调用时对其进行身份验证的购物比较服务 (CSS) 组、CSS、账号或子账号。例如,如果您以高级账号身份进行身份验证,则调用次数会计入高级账号的配额;但如果您以某个子账号的身份进行身份验证,则调用次数会计入该子账号的配额。
该图显示了 CSS 组、CSS、账号和子账号的层次结构。
查看您的配额
如需查看账号的当前配额和用量,请使用账号的 name
调用 quotas.list
。
自动配额仅适用于 products
和 accounts
服务。如果您需要为任何其他服务增加配额、达到了 products
或 accounts
服务的每日配额,或者需要为 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 |
每个国家/地区的配送服务数 ( 每个配送服务的配送组数 ( 每个配送组的标签数 ( 每个配送组的子表数 ( 单个费率表中的行数或列数。 配送标签的长度。 |
20 20 30 100 150 100 |
费率表中的行数或列数会影响以下数组字段:
rowHeaders
或columnHeaders
中的数组字段:prices[]
weights[]
numberOfItems[]
postalCodeGroupNames[]
locations[]
rows[]
cells[]