配額與限制

你的商家帳戶和 Merchant API 用量設有配額和限制。

更新政策

Merchant API 會強制執行下列更新政策：

• 每天最多只能更新兩次產品。您應平均分配每日通話次數，以符合每分鐘配額。
• 你每天最多只能更新子帳戶兩次。
• 每天每個子帳戶最多只能呼叫兩次子帳戶的資料來源方法，例如 list 或 create。

方法呼叫配額

Merchant API 會自動調整下列項目的呼叫配額：

• products 和 accounts 根據用量調整。
• datasources，進階帳戶的費用則取決於子帳戶數量。

我們追蹤配額使用量的方式如下：

• 配額是依方法計算。舉例來說，get 方法的配額與 update 方法的配額不同。
• 無論要求類型為何，系統都會將每個要求計為一次。舉例來說，如果要求 250 個項目，系統只會計為 1 次要求，而不是 250 次。listget
• 系統會根據發出 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

如要查看配額和用量，以及要求增加每日或每分鐘配額，請參閱「查看通話配額」。

自動提高配額無法解決下列錯誤，您必須要求提高商品、動態饋給或子帳戶的配額：

• too_many_items: Merchant quota exceeded
• too_many_subaccounts: Maximum number of sub-accounts reached

帳戶相關限制

您可以使用 accounts.limits.get 和 accounts.limits.list 方法，檢查帳戶層級實體的限制。你可以使用這些方法查看產品限制。

如要擷取特定產品限制 (例如帳戶的 Google Ads 歐洲經濟區配額)，您需要在對 accounts.limits.get 的呼叫中指定帳戶 ID 和限制 ID。限制 ID 是限制類型和範圍的組合。舉例來說，products~ADS_EEA適用於指定在歐洲經濟區放送廣告的產品，products~ADS_NON_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[]