Merchant API 功能設有嚴格的配額和限制。
更新政策
Merchant API 會針對更新強制執行下列政策:
- 你每天最多只能更新產品兩次。
- 您每天只能更新一次子帳戶。
方法呼叫配額
Merchant API 會根據使用情形,自動調整 products
和 accounts
的呼叫配額。
我們會以下列方式追蹤您的配額使用量:
- 配額是按方法計算。舉例來說,
get
方法與update
方法有不同的配額。 - 無論要求類型為何,每個要求都會計為一次。舉例來說,我們會將 250 個項目的
list
要求計為一次,而非 250 個get
要求。 - 配額適用於您在呼叫時進行驗證的購物比較服務 (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 |
依國家/地區劃分的運送服務 ( 每個運送服務的運送群組 ( 每個運送群組的標籤 ( 每個運送群組的子表格 ( 單一費率表中的資料列或資料欄數。 運送標籤的長度。 |
20 20 30 100 150 100 |
費率表中的列數或欄數會影響下列陣列欄位:
rowHeaders
或columnHeaders
中的陣列欄位:prices[]
weights[]
numberOfItems[]
postalCodeGroupNames[]
locations[]
rows[]
cells[]