custombatch là một phương thức phổ biến cho phép bạn nhóm một số lệnh gọi API, còn gọi là "mục nhập" thành một yêu cầu HTTP duy nhất. Mỗi mục chỉ tham chiếu đến một lệnh gọi phương thức duy nhất.
Lô tuỳ chỉnh là lựa chọn phù hợp khi:
- Bạn mới bắt đầu sử dụng API và có nhiều dữ liệu sản phẩm cần tải lên.
- Bạn cần đồng bộ hoá dữ liệu cục bộ với máy chủ bằng cách gửi nhiều thông tin cập nhật và xoá.
Tạo yêu cầu hàng loạt
Việc gửi yêu cầu hàng loạt cũng tương tự như gửi song song lệnh gọi API. Xin lưu ý rằng không có gì đảm bảo rằng thứ tự của các mục nhập được xác định trong yêu cầu sẽ theo thứ tự thực thi. Bạn không nên sử dụng các lệnh gọi phụ thuộc lẫn nhau trong một yêu cầu theo lô duy nhất (chẳng hạn như tạo và cập nhật cùng một lô hàng).
Tương tự, phản hồi nhận được cho các yêu cầu theo lô có thể được trả về theo thứ tự khác với thứ tự của các mục nhập yêu cầu. Bạn có thể sử dụng BatchId để liên kết các yêu cầu và phản hồi vì các phản hồi có thể được trả về ngoài trình tự.
Bạn có thể yêu cầu hàng loạt trong API bằng cách gọi phương thức custombatch thích hợp:
| Tài nguyên và phương thức tuỳ chỉnh hàng loạt tương ứng | |
|---|---|
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 |
Giới hạn
Để tránh xảy ra lỗi khi tải lên các lô lớn, bạn nên giới hạn kích thước của yêu cầu custombatch ở mức tối đa là 1.000 mục. Các mức tối đa sau đây áp dụng cho các yêu cầu custombatch:
- 50.000 mục nhập trong mỗi yêu cầu
custombatch - Kích thước truyền 32 MB
Lệnh gọi vượt quá mức tối đa sẽ dẫn đến lỗi request_too_large sau đây:
"Too many requests in a batch.""Request payload size exceeds the limit: %d bytes."