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