ज़्यादातर सेवाओं में सिंक्रोनस एपीआई होते हैं. इनके लिए, आपको अनुरोध करना होता है
और फिर जवाब का इंतज़ार करना पड़ता है. वहीं, BatchJobService
की मदद से, एक साथ कई सेवाओं पर कई कार्रवाइयां की जा सकती हैं. इसके लिए,
कार्रवाइयों के पूरा होने का इंतज़ार करने की ज़रूरत नहीं होती.
`BatchJobService` में, सेवा के हिसाब से अलग-अलग कार्रवाइयां करने के बजाय, एक ही कार्रवाई से कैंपेन, विज्ञापन ग्रुप, विज्ञापन, शर्तें, लेबल, और फ़ीड आइटम के मिक्स कलेक्शन पर काम किया जा सकता है.BatchJobService
सबमिट की गई कार्रवाइयां एक साथ चलती हैं. साथ ही,
BatchJobService उन कार्रवाइयों को अपने-आप फिर से करने की कोशिश करता है जो अस्थायी गड़बड़ियों की वजह से पूरी नहीं हो पाती हैं. जैसे, अनुरोधों की संख्या की सीमा से जुड़ी गड़बड़ियां. Google Ads API, एपीआई कार्रवाइयों को गिनने के निर्देशों के मुताबिक, हर कार्रवाई को आपकी रोज़ाना की कार्रवाई की सीमा में गिनता है.
BatchJobService की मदद से, अनुरोधों में
अस्थायी आईडी भी इस्तेमाल किए जा सकते हैं. इससे,
एक ही कार्रवाई में एक-दूसरे पर निर्भर कार्रवाइयां सबमिट की जा सकती हैं.
कार्रवाइयां
BatchJobService सभी कार्रवाइयों के साथ काम करता है, जो
MutateOperation में दी गई हैं. हालांकि, इसके कुछ अहम
अपवाद हैं.
Google Ads API, किसी कार्रवाई में मौजूद सभी कार्रवाइयों को, आंशिक तौर पर गड़बड़ी होने की सुविधा चालू करके पूरा करता है. इसलिए, अगर कोई कार्रवाई रद्द कर दी जाती है या अलग-अलग कार्रवाइयां पूरी नहीं हो पाती हैं, तो पूरी हो चुकी कार्रवाइयों को वापस नहीं किया जाएगा .
MutateOperation में मौजूद इन कार्रवाइयों को
एक साथ पूरा करना ज़रूरी है. इसलिए, इनमें आंशिक तौर पर गड़बड़ी होने की सुविधा काम नहीं करती
. साथ ही, इन्हें बैच कार्रवाइयों में इस्तेमाल नहीं किया जा सकता. अपनी कार्रवाइयों में इन कार्रवाइयों को शामिल न करें. साथ ही, अपने अनुरोधों में partial_failure को false पर सेट करें. इसके अलावा, mutate
तरीके का इस्तेमाल GoogleAdsService में करें.
BatchJobService में काम न करने वाली कार्रवाइयां
CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperation