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 jika:
- Anda baru saja mulai menggunakan API dan memiliki banyak data produk untuk diupload.
- Anda perlu menyinkronkan data lokal dengan server dengan mengirimkan banyak update 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 jangan gunakan panggilan yang saling bergantung 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 entri permintaan. BatchId dapat digunakan untuk mengorelasikan permintaan dan respons karena respons dapat ditampilkan di luar urutan.
Anda dapat membuat permintaan batch di API dengan memanggil metode custombatch yang sesuai:
| Resource dan metode batch kustom 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. Maksimum berikut berlaku untuk permintaan custombatch:
- 50.000 entri per permintaan
custombatch - Ukuran transfer 32 MB
Panggilan yang melebihi maksimum akan menghasilkan error request_too_large berikut:
"Too many requests in a batch.""Request payload size exceeds the limit: %d bytes."