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 olanak tanıyan yaygın bir yöntemdir. Her giriş yalnızca tek bir yöntem çağrısına referans verir.
Özel toplu işlem aşağıdaki durumlarda iyi bir seçimdir:
API'yi kullanmaya yeni başladıysanız ve yüklemeniz gereken çok sayıda ürün veriniz varsa
Çok sayıda güncelleme ve silme işlemi göndererek yerel verileri sunucuyla senkronize etmeniz gerekir.
Toplu istek yapma
Toplu istek gönderme, API çağrılarını paralel olarak göndermeye benzer. İstekte tanımlanan girişlerin sırasının, uygulandıkları sırayla aynı olacağı garanti edilmez. Tek bir toplu istekte birbirine bağımlı çağrılar (ör. aynı gönderimi 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ıra dışı şekilde döndürülebileceğinden BatchId, istekleri ve yanıtları ilişkilendirmek için kullanılabilir.
Uygun custombatchyöntemini çağırarak API'de istekleri toplu olarak gönderebilirsiniz:
Kaynaklar ve bunlara karşılık gelen özel toplu yöntemler
Büyük gruplar yüklerken hataları önlemek için custombatch isteklerinin boyutunu en fazla 1.000 girişle sınırlandırmanızı öneririz. custombatch istekleri için aşağıdaki maksimum değerler 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 yol açar:
"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: 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"]]
