配額與限制

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

注意： 配額和限制隨時可能遭到取消、縮減或變更，恕不另行通知。

更新政策

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

• 每天最多只能更新兩次產品。
• 每天只能更新子帳戶一次。

方法呼叫配額

Merchant API 會根據你的用量，自動調整 products 和 accounts 的呼叫配額。

我們會以下列方式追蹤配額使用量：

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

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

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

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

帳戶相關限制

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

如要擷取特定產品限制 (例如取得帳戶的廣告歐洲經濟區配額)，您需要在對 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 中的對應功能。

請注意，這份限制清單可能不完整。我們不會延長這些期限。

資源	欄位	限制
shippingsettings	依國家/地區劃分的運送服務 (services)。 每個運送服務的運送群組 (rateGroups)。 每個運送群組的標籤 (applicableShippingLabels)。 每個運送群組的子表格 (subtables)。 單一費率表中的列數或欄數。 運送標籤的長度。	20 20 30 100 150 100

費率表中的列數或欄數會影響下列陣列欄位：

• rowHeaders 或 columnHeaders 中的陣列欄位：
  • prices[]
  • weights[]
  • numberOfItems[]
  • postalCodeGroupNames[]
  • locations[]
  • rows[]
  • cells[]