बैच अनुरोध

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."