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 yeni kullanmaya başladıysanız ve yüklenecek ç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 istekler oluşturma
Toplu istek gönderme, API çağrılarını paralel olarak göndermeye benzer. İstek içinde tanımlanan girişlerin sırasının, yürütülecekleri sırayla aynı olacağı garanti edilmez. Tek bir toplu istekte birbirine bağımlı çağrıları (ör. aynı gönderiyi oluşturma ve güncelleme) kullanmamanızı öneririz.
Benzer şekilde, toplu istekler için alınan yanıtlar, istek girişlerinin sırasından farklı bir sırada döndürülebilir. Yanıtlar sırayla döndürülmeyebileceğinden, istekleri ve yanıtları ilişkilendirmek için BatchId kullanılabilir.
Uygun custombatch yöntemini çağırarak API'deki istekleri toplu olarak gönderebilirsiniz:
| Kaynaklar ve bunlara karşılık gelen özel toplu iş yöntemleri | |
|---|---|
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 |
Sınırlar
Büyük gruplar yüklerken hata oluşmasını önlemek için custombatch isteklerinin boyutunu maksimum 1.000 girişle sınırlamanızı öneririz. custombatch istekleri için aşağıdaki maksimum değerler geçerlidir:
custombatchisteğ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."