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