custombatch adalah metode umum yang memungkinkan Anda mengelompokkan beberapa panggilan API,
yang dikenal sebagai "entri" ke dalam satu permintaan HTTP. Setiap entri hanya mereferensikan
satu panggilan metode.
Batch kustom adalah pilihan yang baik saat:
- Anda baru saja mulai menggunakan API dan memiliki banyak data produk yang ingin diupload.
- Anda perlu menyinkronkan data lokal dengan server dengan mengirimkan banyak pembaruan dan penghapusan.
Membuat permintaan batch
Mengirim permintaan batch mirip dengan mengirim panggilan API secara paralel. Perhatikan bahwa tidak ada jaminan bahwa urutan entri yang ditentukan dalam permintaan akan sesuai dengan urutan eksekusinya. Sebaiknya Anda tidak menggunakan panggilan interdependen dalam satu permintaan batch (seperti membuat dan memperbarui pengiriman yang sama).
Demikian pula, respons yang diterima untuk permintaan batch dapat ditampilkan dalam
urutan yang berbeda dengan urutan entri permintaan. BatchId dapat digunakan untuk
menghubungkan permintaan dan respons karena respons dapat ditampilkan secara tidak berurutan.
Anda dapat mengelompokkan permintaan di API dengan memanggil metode custombatch
yang sesuai:
| Resource dan metode batch kustomnya yang sesuai | |
|---|---|
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 |
Batas
Untuk menghindari error saat mengupload batch besar, sebaiknya batasi ukuran
permintaan custombatch hingga maksimum 1.000 entri. Jumlah maksimum berikut
berlaku untuk permintaan custombatch:
- 50.000 entri per permintaan
custombatch - Ukuran transfer 32 Mb
Panggilan yang melebihi jumlah maksimum akan menyebabkan error request_too_large
berikut:
"Too many requests in a batch.""Request payload size exceeds the limit: %d bytes."