Google Ads API, आपके इस्तेमाल के उदाहरण के आधार पर संसाधनों में बदलाव करने के कई तरीके उपलब्ध कराता है:
- संसाधन सेवा में बदलाव: हर बदलाव किए जा सकने वाले संसाधन के लिए एक खास सेवा होती है, जो उस संसाधन के लिए कार्रवाइयां करती है. उदाहरण के लिए,
Campaignरिसॉर्स, कैंपेन बनाने, अपडेट करने या हटाने के लिए,CampaignService.MutateCampaignsएंडपॉइंट का इस्तेमाल करता है. - एक साथ कई बदलाव करना:
GoogleAdsService.Mutateएंडपॉइंट, एक ही सिंक्रोनस रिक्वेस्ट में कई तरह के संसाधनों (और बुकिंग या कोटेशन कैंपेन जैसी कार्रवाइयों) में बदलाव करने की प्रोसेस को रैप करता है. - एसिंक्रोनस बैच जॉब: बड़े पैमाने पर होने वाले म्यूटेशन या लंबे समय तक चलने वाले वर्कलोड के लिए,
BatchJobServiceएसिंक्रोनस तरीके से कार्रवाइयां करता है. इससे सिंक्रोनस रिक्वेस्ट के टाइम आउट होने का जोखिम नहीं रहता.GoogleAdsService.Mutateके उलट,BatchJobServiceहमेशा कुछ हद तक गड़बड़ी वाले सिमैंटिक के तहत काम करता है. साथ ही, यहvalidate_onlyमोड या कार्रवाई से जुड़े ऑपरेशन (book_campaigns_operation,quote_campaigns_operation) के साथ काम नहीं करता. कुछ हद तक गड़बड़ी वाला सिमैंटिक हमेशा चालू रहता है. इसलिए,BatchJobServiceउन संसाधन ऑपरेशन को अस्वीकार कर देता है जिनकी सेवाएं कुछ हद तक गड़बड़ी वाले सिमैंटिक के साथ काम नहीं करतीं. जैसे,CustomerOperation,CampaignConversionGoalOperation,ConversionGoalCampaignConfigOperation,CustomConversionGoalOperation, औरCustomerConversionGoalOperation. साथ ही, यहMutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILUREगड़बड़ी दिखाता है.
एक साथ कई बदलाव करने के फ़ायदे
GoogleAdsService.Mutate का इस्तेमाल करने से ये फ़ायदे मिलते हैं. इसे लागू करने के बारे में जानने के लिए, Mutate के सबसे सही तरीके देखें:
- अलग-अलग रिसॉर्स सेवाओं के लिए ग्रुप में की जाने वाली कार्रवाइयां: अलग-अलग रिसॉर्स सेवा कॉल, सिर्फ़ एक तरह के रिसॉर्स के लिए कार्रवाइयां स्वीकार करते हैं. हालांकि,
GoogleAdsService.Mutateकी मदद से, एक ही कॉल में कई तरह के रिसॉर्स में बदलाव किया जा सकता है. - संसाधनों के अस्थायी नाम: नई बनाई गई पैरंट इकाइयों को नेगेटिव इंटिजर आईडी (जैसे,
customers/CUSTOMER_ID/campaigns/-1) असाइन किए जा सकते हैं. साथ ही, एक ही अनुरोध में चाइल्ड ऑपरेशन में उन अस्थायी आईडी को रेफ़रंस के तौर पर इस्तेमाल किया जा सकता है.
इन सुविधाओं की मदद से, GoogleAdsService.Mutate का इस्तेमाल करके, पूरे कैंपेन की हैरारकी को एक साथ बनाया जा सकता है. इससे सभी ऑपरेशन एक साथ सफल या असफल होते हैं. इसके अलावा, मान्य ऑपरेशन को अलग से लागू करने के लिए, partial_failure को true पर सेट किया जा सकता है.