Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
custombatch adalah metode umum yang memungkinkan Anda mengelompokkan beberapa panggilan API, yang dikenal sebagai "entri", menjadi 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 dalam batch dapat ditampilkan dalam urutan yang berbeda dengan entri permintaan. BatchId dapat digunakan untuk
mempertautkan permintaan dan respons karena respons mungkin ditampilkan secara tidak
berurutan.
Anda dapat mengelompokkan permintaan di API dengan memanggil metode custombatch
yang sesuai:
Untuk menghindari error saat mengupload batch besar, sebaiknya batasi ukuran
permintaan custombatch hingga maksimum 1.000 entri. Batas maksimum berikut
berlaku untuk permintaan custombatch:
50.000 entri per permintaan custombatch
Ukuran transfer 32 Mb
Panggilan yang melebihi maksimum akan menyebabkan error request_too_large berikut:
"Too many requests in a batch."
"Request payload size exceeds the limit: %d bytes."
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-06-19 UTC."],[[["The Merchant API is the new version of the Content API for Shopping and is now in beta."],["Use the `custombatch` method to group several API calls into a single HTTP request for efficiency, especially for initial data uploads and synchronization."],["Batch requests have a limit of 50,000 entries and 32Mb transfer size; exceeding these limits will result in errors."],["There's no guarantee that batched requests will be executed or returned in the order they were defined; use `BatchId` to correlate requests and responses."],["For more details and to learn how the Merchant API can improve your integration, visit the announcement blog post."]]],["The Merchant API beta, a new version of the Content API for Shopping, is introduced. It uses `custombatch`, a method to group multiple API calls into a single HTTP request for efficient data uploading and synchronization. `Custombatch` suits large data transfers but doesn't guarantee execution order. `BatchId` correlates requests and responses. Batches can have top-level or entry-specific errors. There is a recommended limit of 1,000 entries per batch with maximum limits of 50,000 entries, and 32Mb size.\n"]]
