custombatch 是一種常見的方法，可讓您將多個 API 呼叫 (稱為「項目」) 歸入單一 HTTP 要求。每個項目都只會參照一個方法呼叫。
在下列情況下，建議使用自訂批次：
- 您剛開始使用 API，有許多要上傳的產品資料。
- 您需要傳送大量更新和刪除資料，以便與伺服器同步處理本機資料。
提出批次要求
傳送批次要求與同時傳送 API 呼叫的方式類似。請注意，系統無法保證要求中定義的項目順序會依執行順序排列。建議您不要在單一批次要求中使用互附呼叫 (例如建立及更新相同運送)。
同樣地，針對批次要求所接收的回應，系統可能會以不同的順序傳回要求項目。BatchId 可用於連結要求和回應之間的關係，因為回應可能不會全部傳回。
您可以在 API 中呼叫適當的 custombatch 方法，藉此批次處理要求：
| 資源及其對應的自訂批次方法 | |
|---|---|
Accounts |
accounts.custombatch |
Accountstatuses |
accountstatuses.custombatch |
Accounttax |
accounttax.custombatch |
Datafeeds |
datafeeds.custombatch |
Datafeedstatuses |
datafeedstatuses.custombatch |
Localinventory |
localinventory.custombatch
|
Liasettings |
liasettings.custombatch |
Pos |
pos.custombatch |
Products |
products.custombatch |
Productstatuses |
productstatuses.custombatch |
Shippingsettings |
shippingsettings.custombatch |
限制
為避免上傳大型批次時發生錯誤，建議您將 custombatch 要求的大小限制為 1,000 個項目。下列上限值適用於 custombatch 要求：
- 每
custombatch要求 50,000 個項目 - 32 MB 移轉作業大小
如果呼叫超過該上限，會導致下列 request_too_large 錯誤：
"Too many requests in a batch.""Request payload size exceeds the limit: %d bytes."