Merchant API 功能具有严格的配额和限制。
更新政策
Merchant API 在更新方面会强制执行以下政策:
- 您每天最多只能更新商品两次。
- 您每天只能更新一次子账号。
Merchant API 和 Content API for Shopping 之间的配额相关变更
- 配额将按资源(而非方法)计算。这意味着,部分服务现已关联。
- 不使用自定义批处理不会影响配额计算。例如,包含 500 个插入请求的批量请求将按 500 个单独的插入方法请求进行计费。
- 账号和商品的配额自动化功能仍会保留。
- 如需确定当前的配额用量和限制(包括自动化和替换项),请使用 Quota.list 方法。
方法调用配额
Merchant API 会根据您的使用情况,自动调整 products
和 accounts
的调用配额。
我们会通过以下方式跟踪您的配额使用情况:
- 配额是按方法划分的。例如,
get
方法和update
方法的配额是分别独立的。 - 无论请求类型如何,每个请求都会统计一次。例如,我们会将包含 250 项的
list
请求计为 1 次,而不是 250 次get
请求。 - 配额费用是根据发出 API 请求的用户计算的。如果用户是高级账号的直接成员,则系统会在高级账号一级扣减配额。
- 配额适用于您在发出调用时对其进行身份验证的购物比较服务 (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[]