配额和限制

您的商家账号和 Merchant API 使用受配额和限制的约束。

更新政策

Merchant API 在更新方面实施以下政策：

• 您每天最多只能更新两次产品。您应将每日调用次数均匀分布在一天中，以符合每分钟配额。
• 您每天只能更新一次子账号。

方法调用配额

Merchant API 会根据您的使用情况自动调整 products 和 accounts 的调用配额。

以下是我们跟踪配额使用情况的方式：

• 配额是针对方法的。例如，get 方法的配额与 update 方法的配额是分开的。
• 无论请求类型如何，每个请求都计为一次。例如，我们对包含 250 个商品的 list 请求计为一次，而不是 250 个 get 请求。
• 配额根据发出 API 请求的用户收费。如果用户是高级账号的直接成员，则配额将按高级账号级别收费。
• 配额适用于您在进行调用时针对其进行身份验证的购物比较服务 (CSS) 组、CSS、 账号或 子账号 。例如，如果您 以高级账号的身份进行身份验证， 则调用将计入您的高级账号配额；但如果您 以其中一个子账号的身份进行身份验证，则调用将计入该 子账号的配额。

该图显示了 CSS 组、CSS、账号和子账号的层次结构。

Content API for Shopping 的方法调用配额变更

如果您使用过 Content API for Shopping，请注意 Merchant API 中的以下方法调用配额变更：

• 缺少自定义批处理不会影响配额计算。 例如，包含 500 个插入请求的批量请求将按 500 个单独的插入方法请求收费。
• 账号和产品的配额自动化功能保持不变。
• 如需确定您当前的配额使用情况和限制（包括自动化和替换），请使用 Quota.list 方法。

查看您的调用配额

如需查看账号的当前调用配额和使用情况，请使用账号的 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

账号限制

您可以使用 accounts.limits.get 和 accounts.limits.list 方法查看 账号级实体的限制。 您可以使用这些方法查看产品限制。

如需检索特定产品限制（例如获取账号的广告 EEA 配额），您需要在对 accounts.limits.get 的调用中指定账号 ID 和限制 ID 。 限制 ID 是限制类型和范围的组合。例如，products~ADS_EEA 表示面向 EEA 广告的产品，products~ADS_NON_EEA 表示面向 EEA 以外广告的产品。

以下是获取给定账号的 products~ADS_EEA 限制的示例请求：

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits/products~ADS_EEA

如需了解账号可用的限制 ID，请使用 accounts.limits.list 并使用 type="products" 过滤条件：

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits?filter=type%3D%22products%22

如需详细了解产品配额，请参阅 了解 Google Merchant Center 中的配额。

资源表示法限制

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

请注意，此处可能并未详尽列出所有限制，而且我们不会放宽这些限制。

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

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