配額與限制

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

更新政策

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

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

方法呼叫配額

Merchant API 會根據使用情形,自動調整 productsaccounts 的呼叫配額。

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

  • 配額是按方法計算。舉例來說,get 方法與 update 方法有不同的配額。
  • 無論要求類型為何,每個要求都會計為一次。舉例來說,我們會將 250 個項目的 list 要求計為一次,而非 250 個 get 要求。
  • 配額適用於您在呼叫時進行驗證的購物比較服務 (CSS) 群組、CSS、帳戶或子帳戶。舉例來說,如果您以進階帳戶身分進行驗證,通話會計入進階帳戶配額,但如果您以其中一個子帳戶身分進行驗證,通話會計入子帳戶配額。

圖表顯示 CSS 群組、CSS、帳戶和子帳戶的階層。 圖片顯示 CSS 群組是整體驗證層級,其中可能包含個別 CSS、個別 CSS 中的帳戶和子帳戶。

查看配額

如要查看帳戶目前的配額和用量,請使用帳戶的 name 呼叫 quotas.list

自動配額僅適用於 productsaccounts 服務。如果您需要增加其他服務的配額、已達 productsaccounts 服務的每日配額,或是需要暫時增加 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

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

  • rowHeaderscolumnHeaders 中的陣列欄位:
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]