配額與限制

Merchant API 功能設有嚴格的配額和限制。

更新政策

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

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

Merchant API 和 Content API for Shopping 的配額相關異動

• 配額會依資源而非方法計算。這表示部分服務已連結。
• 沒有自訂批次處理功能不會影響配額計算。舉例來說，如果批次要求包含 500 個插入要求，系統會以 500 個個別插入方法要求收費。
• 帳戶和產品的配額自動化功能仍會維持原樣。
• 如要判斷目前的配額用量和限制 (包括自動化和覆寫)，請使用 Quota.list 方法。

方法呼叫配額

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

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

• 配額是按方法計算。舉例來說，get 方法與 update 方法有不同的配額。
• 無論要求類型為何，每個要求都會計為一次。舉例來說，我們會將 250 個項目的 list 要求計為一次，而非 250 個 get 要求。
• 系統會根據提出 API 要求的使用者收取配額費用。如果使用者是進階帳戶的直接成員，系統會以進階帳戶的等級收取配額費用。
• 配額適用於購物比較服務 (CSS) 群組、CSS、帳戶或子帳戶，您在呼叫時會針對這些項目進行驗證。舉例來說，如果您以進階帳戶身分進行驗證，通話會計入進階帳戶的配額，但如果您以其中一個子帳戶身分進行驗證，通話會計入子帳戶的配額。

圖表顯示 CSS 群組、CSS、帳戶和子帳戶的階層。

查看配額

如要查看帳戶目前的配額和用量，請使用帳戶的 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

資源表示法限制

以下限制說明瞭 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[]