配额和限制

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	每个国家/地区的配送服务数 (services)。 每项配送服务的配送组数 (rateGroups)。 每个配送组的标签数 (applicableShippingLabels)。 每个配送组的子表数 (subtables)。 单个费率表中的行数或列数。 配送标签的长度。	20 20 30 100 150 100

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

• rowHeaders 或 columnHeaders 中的数组字段：
  • prices[]
  • weights[]
  • numberOfItems[]
  • postalCodeGroupNames[]
  • locations[]
  • rows[]
  • cells[]