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