custombatch एक सामान्य तरीका है, जिससे कई एपीआई कॉल को एक ही एचटीटीपी अनुरोध में ग्रुप
बनाया जा सकता है. इन एपीआई कॉल को "एंट्री" भी कहा जाता है. हर एंट्री सिर्फ़ एक तरीके
से होने वाले कॉल का रेफ़रंस देती है.
कस्टम बैच तब सबसे अच्छा विकल्प होता है, जब:
- आपने अभी-अभी एपीआई का इस्तेमाल शुरू किया है और आपके पास अपलोड करने के लिए काफ़ी प्रॉडक्ट डेटा है.
- आपको ढेर सारे अपडेट भेजकर और कई अपडेट भेजकर स्थानीय डेटा को सर्वर के साथ सिंक करना होगा.
बैच में अनुरोध करें
एक साथ कई अनुरोध भेजना, एपीआई कॉल को एक साथ भेजने जैसा ही है. ध्यान दें कि इस बात की कोई गारंटी नहीं है कि अनुरोध में बताई गई एंट्री का क्रम उसी क्रम में होगा जिस क्रम में उन्हें लागू किया जाता है. हमारा सुझाव है कि आप एक ही बैच के अनुरोध में दूसरे कॉल के लिए इस्तेमाल न करें. जैसे, एक ही शिपमेंट बनाना और अपडेट करना.
इसी तरह, बैच में भेजे गए अनुरोधों के लिए मिले रिस्पॉन्स, अनुरोध एंट्री के क्रम में अलग हो सकते हैं. BatchId का इस्तेमाल, अनुरोधों और जवाबों को जोड़ने के लिए किया जा सकता है, क्योंकि हो सकता है कि रिस्पॉन्स, क्रम से बाहर दिखाए जाएं.
सही custombatch तरीके का इस्तेमाल करके, एपीआई में कई अनुरोध भेजे जा सकते हैं:
| संसाधन और उनसे जुड़े कस्टम बैच के तरीके | |
|---|---|
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 |
सीमाएं
बड़े बैच को अपलोड करते समय होने वाली गड़बड़ियों से बचने के लिए, हमारा सुझाव है कि custombatch अनुरोधों का साइज़ ज़्यादा से ज़्यादा 1,000 एंट्री तक सीमित रखें. custombatch अनुरोधों पर
ज़्यादा से ज़्यादा संख्या लागू होती है:
- हर
custombatchअनुरोध पर 50,000 एंट्री - 32 एमबी ट्रांसफ़र साइज़
तय सीमा से ज़्यादा कॉल करने पर, नीचे दी गई request_too_large गड़बड़ियां हो सकती हैं:
"Too many requests in a batch.""Request payload size exceeds the limit: %d bytes."