配额和限制

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

更新政策

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

• 您每天最多只能更新两次商品。您应将每日调用均匀分布在一天中，以符合每分钟配额。
• 您每天最多只能更新两次子账号。
• 您每天最多只能为每个子账号调用两次子账号的数据源方法（例如 list 或 create）。

方法调用配额

Merchant API 会自动调整以下内容的调用配额：

• 根据您的使用情况调整 products 和 accounts。
• datasources 根据高级 账号的子账号数量调整。

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

• 配额是针对方法的。例如，get 方法的配额与 update 方法的配额是分开的。
• 无论请求类型如何，每个请求都计为一次。例如，我们对包含 250 个商品的 list 请求计为一次，而不是 250 个 get 请求。
• 配额根据发出 API 请求的用户收费。如果用户是高级账号的直接成员，则配额将按高级账号级别收费。
• 对于 datasources 服务，自动配额扩缩仅适用于高级账号，具体取决于其子账号数量。独立账号和子账号的配额是静态的，通常不支持增加。如需查看 datasource 配额限制，请使用 accounts.limits 方法。
• 配额适用于您在进行调用时针对其进行身份验证的购物比较服务 (CSS) 组、CSS、 账号或 子账号 。例如，如果您 以高级账号的身份进行身份验证， 则调用将计入您的高级账号配额；但如果您 以其中一个子账号的身份进行身份验证，则调用将计入该 子账号的配额。

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

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

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

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

查看您的调用配额

如需查看账号的当前调用配额和使用情况，请使用账号的 name 调用 quotas.list 。

自动配额适用于 products、accounts 和 datasources 服务。

• 对于具有自动配额的资源（高级账号的 products、accounts 和 datasources）： 您只能针对特殊情况（例如在新市场推出或在流量高峰购物季期间）申请临时增加配额 。我们不接受此类资源的永久配额增加申请。
• 对于所有其他没有自动配额的资源： 您可以根据需要申请增加配额。

请使用“ 联系支持团队”表单中的 Quota increase request 问题，并填写以下信息：

• 您的 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[]