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 gọi là "mục nhập" thành một yêu cầu HTTP duy nhất. Mỗi mục nhập 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 này 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 nội dung cập nhật và xoá.
Thực hiện yêu cầu hàng loạt
Việc gửi yêu cầu theo lô tương tự như việc 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ự được thực thi. Bạn không nên sử dụng các lệnh gọi phụ thuộc trong một yêu cầu 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 phản hồi 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ể bị trả về không theo trình tự.
Bạn có thể gọi lô các yêu cầu 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 nhóm tuỳ chỉnh 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 |
Các giới hạn
Để tránh 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 các yêu cầu custombatch ở mức tối đa là 1.000 mục nhập. Các mức tối đa sau đây áp dụng cho yêu cầu custombatch:
- 50.000 mục cho mỗi
custombatchyêu cầu - Kích thước chuyển 32 MB
Những lệnh gọi vượt quá mức tối đa sẽ dẫn đến lỗi request_too_large sau:
"Too many requests in a batch.""Request payload size exceeds the limit: %d bytes."