custombatch एक सामान्य तरीका है, जिसकी मदद से कई एपीआई कॉल को एक साथ ग्रुप किया जा सकता है. इन कॉल को "एंट्री" कहा जाता है. हर एंट्री में सिर्फ़ एक मेथड कॉल का रेफ़रंस होता है.
कस्टम बैच का इस्तेमाल तब करना चाहिए, जब:
- आपने हाल ही में एपीआई का इस्तेमाल शुरू किया है और आपके पास अपलोड करने के लिए बहुत सारा प्रॉडक्ट डेटा है.
- आपको बहुत सारे अपडेट और मिटाए गए डेटा भेजकर, लोकल डेटा को सर्वर के साथ सिंक करना होगा.
एक साथ कई अनुरोध करना
एक साथ कई अनुरोध भेजना, एक साथ कई API कॉल भेजने जैसा ही है. ध्यान दें कि इस बात की कोई गारंटी नहीं है कि अनुरोध में बताई गई एंट्री का क्रम, लागू करने के क्रम में होगा. हमारा सुझाव है कि एक ही बैच अनुरोध में, एक-दूसरे पर निर्भर कॉल का इस्तेमाल न करें. जैसे, एक ही शिपमेंट बनाना और अपडेट करना.
इसी तरह, एक साथ किए गए अनुरोधों के लिए मिले जवाब, अनुरोध की एंट्री के क्रम से अलग क्रम में दिए जा सकते हैं. 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."