Google Ads API, इस्तेमाल के उदाहरण के आधार पर संसाधनों में बदलाव करने के कई तरीके उपलब्ध कराता है:
- संसाधन सेवा में बदलाव होता है: बदलाव किए जा सकने वाले हर संसाधन के लिए एक खास सेवा होती है. यह सेवा, उस संसाधन टाइप के लिए कार्रवाइयां करती है. उदाहरण के लिए,
Campaignसंसाधन, कैंपेन बनाने, अपडेट करने या हटाने के लिएCampaignService.MutateCampaignsएंडपॉइंट का इस्तेमाल करता है. - एक साथ कई बदलाव करना:
GoogleAdsService.Mutateएंडपॉइंट, एक साथ कई बदलाव करने की सुविधा देता है. इसकी मदद से, एक साथ कई तरह के संसाधनों में बदलाव किए जा सकते हैं. साथ ही, वर्शन 23 और इसके बाद के वर्शन में, बुकिंग या कोटेशन वाले कैंपेन जैसे ऐक्शन ऑपरेशन भी किए जा सकते हैं. ये सभी बदलाव, एक ही सिंक्रोनस अनुरोध में किए जाते हैं. - एसिंक्रोनस बैच जॉब: बड़े पैमाने पर म्यूटेशन या लंबे समय तक चलने वाले वर्कलोड के लिए,
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 का इस्तेमाल करने से ये फ़ायदे मिलते हैं. इसे लागू करने के बारे में जानने के लिए, बदलाव करने के सबसे सही तरीके देखें:
- अलग-अलग रिसॉर्स सेवाओं के लिए ग्रुप की गई कार्रवाइयां: अलग-अलग रिसॉर्स सेवाओं के लिए किए जाने वाले कॉल में, सिर्फ़ एक तरह के रिसॉर्स के लिए कार्रवाइयां स्वीकार की जाती हैं. वहीं,
GoogleAdsService.Mutateकी मदद से एक ही कॉल में, कई तरह के रिसॉर्स में बदलाव किया जा सकता है. - अस्थायी संसाधन के नाम: नई बनाई गई पैरंट इकाइयों को नेगेटिव पूर्णांक आईडी (जैसे कि
customers/CUSTOMER_ID/campaigns/-1) असाइन किए जा सकते हैं. साथ ही, एक ही अनुरोध में चाइल्ड कार्रवाइयों में उन अस्थायी आईडी को रेफ़र किया जा सकता है.
इन सुविधाओं की मदद से, GoogleAdsService.Mutate का इस्तेमाल करके, पूरी कैंपेन हैरारकी को एक साथ बनाया जा सकता है, ताकि सभी कार्रवाइयां एक साथ पूरी हों या एक साथ फ़ेल हों. इसके अलावा, partial_failure को true पर सेट करके, मान्य कार्रवाइयों को अलग-अलग तरीके से पूरा किया जा सकता है.