配额和限制

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

注意： Google 有权随时取消、减少或更改配额和限制，恕不另行通知。

更新政策

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 方法。

注意： 对于 accounts.list 方法，配额和限制使用情况是按每个用户收费的，而不是按 Merchant Center ID 或高级账号 ID 收费。如需列出子账号，您应使用更适合此用例的 accounts.listSubaccounts 方法。

查看通话配额

如需查看账号当前的调用配额和用量，请使用账号的 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 中的相应功能，这些限制都适用。

请注意，此处可能并未详尽列出所有限制。我们不会延长这些期限。

资源	字段	限制
shippingsettings	每个国家/地区的配送服务数 (services)。 每项配送服务的配送组数 (rateGroups)。 每个配送组的标签数 (applicableShippingLabels)。 每个配送组的子表数 (subtables)。 单个费率表中的行数或列数。 配送标签的长度。	20 20 30 100 150 100

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

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