custombatch 是一種常見的方法，可將多個 API 呼叫 (稱為「項目」) 組合成單一 HTTP 要求。每個項目都只會參照單一方法呼叫。
自訂批次在下列情況下相當理想：
- 您剛開始使用 API，尚未上傳大量產品資料。
- 您必須傳送大量的更新和刪除內容，讓本機資料與伺服器保持同步。
提出批次要求
傳送批次要求與同時傳送 API 呼叫類似。請注意，我們無法保證要求中定義的項目順序會按照項目的執行順序排列。建議您不要在單一批次要求中使用互斥呼叫 (例如建立及更新相同的出貨資訊)。
同樣地，批次要求收到的回應可能會以與要求項目不同的順序傳回。BatchId 可用來將要求和回應建立關聯，因為回應可能會延遲傳回。
您可以透過呼叫適當的 custombatch 方法，在 API 中批次處理要求：
| 資源和相應的自訂批次方法 | |
|---|---|
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."