Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
custombatch, "girişler" olarak bilinen çeşitli API çağrılarını tek bir HTTP isteğinde gruplandırmanıza imkan tanıyan yaygın bir yöntemdir. Her giriş, yalnızca tek bir yöntem çağrısına referans verir.
Aşağıdaki durumlarda özel grup iyi bir seçenektir:
API'yi kullanmaya yeni başladınız ve yüklenecek çok fazla ürün veriniz var.
Çok sayıda güncelleme ve silme göndererek yerel verileri sunucuyla senkronize etmeniz gerekir.
Toplu istekler yapma
Toplu istek gönderme, paralel olarak API çağrıları göndermeye benzer. İstekte tanımlanan girişlerin sırasının, yürütüldüğü sıranın olacağına dair bir garanti olmadığını unutmayın. Birbirine bağlı çağrıları tek bir toplu istekte (ör. aynı kargoyu oluşturma ve güncelleme) kullanmamanızı öneririz.
Benzer şekilde, toplu istekler için alınan yanıtlar, istek girişlerinden farklı bir sırada döndürülebilir. Yanıtlar sıralı olarak döndürülebileceği için BatchId, istekleri ve yanıtları ilişkilendirmek için kullanılabilir.
Uygun custombatch yöntemini çağırarak API'de toplu istek gönderebilirsiniz:
Kaynaklar ve bunlara karşılık gelen özel toplu işlem yöntemleri
Büyük gruplar yüklerken hata olmaması için custombatch isteklerinin boyutunu en fazla 1.000 girişle sınırlandırmanızı öneririz. Aşağıdaki maksimum değerler custombatch istekleri için geçerlidir:
custombatch isteği başına 50.000 giriş
32 Mb aktarım boyutu
Maksimum değerleri aşan çağrılar aşağıdaki request_too_large hatalarına neden olur:
"Too many requests in a batch."
"Request payload size exceeds the limit: %d bytes."
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2024-07-03 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"]]
