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