नए वर्शन पर माइग्रेट करें

Campaign Manager 360 API के नए वर्शन नियमित तौर पर रिलीज़ किए जाते हैं. नए वर्शन रिलीज़ होने पर, पुराने वर्शन का इस्तेमाल बंद कर दिया जाता है और आखिर में उन्हें बंद कर दिया जाता है. जब किसी वर्शन को बंद कर दिया जाता है, तो उस वर्शन के लिए किए गए सभी अनुरोधों से गड़बड़ियां दिखने लगती हैं.

अगर एपीआई का इस्तेमाल किया जा रहा वर्शन बंद कर दिया गया है, तो आपको बंद होने की शेड्यूल की गई तारीख से पहले, नए वर्शन पर माइग्रेट करना होगा. इस गाइड में, यह पता लगाने का तरीका बताया गया है कि आपके इस्तेमाल किए जा रहे एपीआई वर्शन का इस्तेमाल बंद कर दिया गया है या नहीं. साथ ही, इसमें माइग्रेशन के लिए सुझाए गए तरीके भी बताए गए हैं.

पहला चरण: यह पता लगाना कि आपके पास किस वर्शन का ऐप्लिकेशन है

अगर आपके पास ऐसा ऐप्लिकेशन है जिसके बारे में आपको लगता है कि वह Campaign Manager 360 API के ऐसे वर्शन का इस्तेमाल कर रहा है जिसका इस्तेमाल नहीं किया जा सकता, तो आपको सबसे पहले यह पुष्टि करनी चाहिए कि कौनसा वर्शन इस्तेमाल किया जा रहा है. ज़्यादातर मामलों में, आपको एपीआई को भाषा के हिसाब से बनी क्लाइंट लाइब्रेरी या आधिकारिक इंटिग्रेशन की मदद से ऐक्सेस करना होगा. इन क्लाइंट लाइब्रेरी और इंटिग्रेशन में इस्तेमाल किए जा रहे एपीआई वर्शन को ढूंढने के निर्देश यहां दिए गए हैं:

Apps Script का नया एडिटर

बेहतर सेवाओं के डायलॉग बॉक्स में, Apps Script के वर्शन की जानकारी दिखती है:

1. Apps Script एडिटर में, सेवा जोड़ें पर क्लिक करें.
2. उपलब्ध सेवाओं की सूची में, Campaign Manager 360 API ढूंढें.
3. वर्शन ड्रॉपडाउन में चुनी गई वैल्यू, Campaign Manager 360 API का वह वर्शन है जो फ़िलहाल इस्तेमाल किया जा रहा है.

Apps Script का लेगसी एडिटर

बेहतर सेवाओं के डायलॉग बॉक्स में, Apps Script के वर्शन की जानकारी दिखती है:

1. Apps Script एडिटर में, संसाधन > Google की बेहतर सेवाएं पर जाएं.
2. उपलब्ध सेवाओं की सूची में, Campaign Manager 360 API ढूंढें.
3. वर्शन ड्रॉपडाउन में चुनी गई वैल्यू, Campaign Manager 360 API का वह वर्शन है जो फ़िलहाल इस्तेमाल किया जा रहा है.

C#

.NET के लिए Google API क्लाइंट लाइब्रेरी के वर्शन की जानकारी यहां दी गई है:

1. यह नाम, nuget पैकेज के नाम और सेवा के नेमस्पेस में शामिल होता है.

   Google.Apis.Dfareporting.v3_4

2. DfareportingService की सार्वजनिक प्रॉपर्टी के ज़रिए एक्सपोज़ किया गया हो.

   Console.WriteLine(DfareportingService.Version);

Java

Java के लिए Google API क्लाइंट लाइब्रेरी के वर्शन की जानकारी यहां दी गई है:

1. मेवन artifactId में बताया गया है.

   <dependency>
     <groupId>com.google.apis</groupId>
     <artifactId>google-api-services-dfareporting</artifactId>
     <version>v3.4-rev1-1.21.0</version>
   </dependency>

2. JAR फ़ाइल के नाम में शामिल है.

   google-api-services-dfareporting-v3.4-rev1-1.21.0.jar

3. Dfareporting की सार्वजनिक प्रॉपर्टी के ज़रिए एक्सपोज़ किया गया हो.

   System.out.println(Dfareporting.DEFAULT_SERVICE_PATH);

PHP

PHP के लिए Google API क्लाइंट लाइब्रेरी के वर्शन की जानकारी, Google_Service_Dfareporting की सार्वजनिक प्रॉपर्टी के ज़रिए दिखाई जाती है:

$service = new Google_Service_Dfareporting($client)
print $service->version;

Python

Python (v1/v2) के लिए Google API क्लाइंट लाइब्रेरी का कोई वर्शन नहीं है. इस्तेमाल किए जाने वाले एपीआई वर्शन को डिस्कवरी बिल्डर के लिए आर्ग्युमेंट के तौर पर बताया जाता है:

discovery.build('dfareporting', 'v3.4', http=http)

Ruby

Ruby के लिए Google API क्लाइंट लाइब्रेरी के 0.9 से पहले के वर्शन, वर्शन के हिसाब से नहीं हैं. इस्तेमाल किए जाने वाले एपीआई वर्शन को, सेवा कंस्ट्रक्टर के लिए आर्ग्युमेंट के तौर पर तय किया जाता है:

service = Google::APIClient::Service.new("dfareporting", "v3.4",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)

Ruby के लिए Google API क्लाइंट लाइब्रेरी के 0.9 और उसके बाद के वर्शन के लिए, वर्शन को सेवा नेमस्पेस में दिखाया जाता है:

Google.Apis.DfareportingV3_4

इस्तेमाल किए जा रहे वर्शन को नोट करें, क्योंकि आपको इस जानकारी की बाद में ज़रूरत पड़ेगी.

दूसरा चरण: अपने वर्शन की स्थिति देखना

इस्तेमाल में नहीं होने की समयावधि तय करने की सुविधा में, हर उस वर्शन का स्टेटस दिखता है जो फ़िलहाल काम करता है. इस सूची में अपना वर्शन ढूंढें और इसकी स्थिति यहां बताए गए तरीके से देखें:

1. अगर इस्तेमाल में नहीं होने की तारीख और बंद होने की तारीख कॉलम में कोई तारीख नहीं दी गई है, तो इसका मतलब है कि आपने पूरी तरह से काम करने वाले वर्शन का इस्तेमाल किया है.
2. अगर तारीखें दी गई हैं, तो इसका मतलब है कि आपका इस्तेमाल किया जा रहा वर्शन अब काम नहीं करेगा. यह बताई गई तारीख को बंद कर दिया जाएगा.
3. अगर आपका वर्शन सूची में नहीं है, तो इसका मतलब है कि उसे पहले ही बंद कर दिया गया है और अब वह काम नहीं करता.

अगर आपका ऐप्लिकेशन ऊपर बताए गए #2 या #3 में आता है, तो सेवा में रुकावट से बचने के लिए, आपको नए वर्शन पर माइग्रेट करना होगा. हमारा सुझाव है कि आप सबसे नए वर्शन पर माइग्रेट करें. यह वर्शन, बंद होने के शेड्यूल की टेबल में सबसे ऊपर मौजूद है. इसमें बीटा रिलीज़ शामिल नहीं हैं. इससे, आपको अपग्रेड के बीच ज़्यादा से ज़्यादा समय मिलेगा.

तीसरा चरण: वर्शन अपग्रेड करना

अगर आपने यह तय कर लिया है कि आपको माइग्रेट करना है, तो अगला चरण अपने इंटिग्रेशन को अपडेट करना या अपनी पसंदीदा क्लाइंट लाइब्रेरी का अपडेट किया गया बिल्ड हासिल करना है. ध्यान दें कि कुछ क्लाइंट लाइब्रेरी सिर्फ़ एक ऐसा बिल्ड उपलब्ध करा सकती हैं जो किसी भी एपीआई वर्शन के साथ काम करता है. वहीं, दूसरी लाइब्रेरी में हर वर्शन के लिए अलग-अलग बिल्ड होंगे. यहां दी गई सूची में, सबसे ज़्यादा इस्तेमाल की जाने वाली क्लाइंट लाइब्रेरी और इंटिग्रेशन के लिए, अपग्रेड से जुड़ी सामान्य जानकारी दी गई है.

Apps Script का नया एडिटर

Google Apps Script, Campaign Manager 360 API के सभी वर्शन के साथ काम करता है. साथ ही, आपको हर स्क्रिप्ट के हिसाब से इस्तेमाल करने के लिए वर्शन चुनने की सुविधा देता है. किसी खास स्क्रिप्ट के इस्तेमाल किए गए वर्शन को बदलने के लिए:

1. Apps Script एडिटर में, सेवा जोड़ें पर क्लिक करें.
2. उपलब्ध सेवाओं की सूची में, Campaign Manager 360 API ढूंढें.
3. वर्शन ड्रॉपडाउन की मदद से, इस्तेमाल में मौजूद Campaign Manager 360 API वर्शन बदलें.
4. अपने बदलावों को सेव करने के लिए, जोड़ें पर क्लिक करें.

Apps Script का लेगसी एडिटर

Google Apps Script, Campaign Manager 360 API के सभी वर्शन के साथ काम करता है. साथ ही, आपको हर स्क्रिप्ट के हिसाब से इस्तेमाल करने के लिए वर्शन चुनने की सुविधा देता है. किसी खास स्क्रिप्ट के इस्तेमाल किए गए वर्शन को बदलने के लिए:

1. Apps Script एडिटर में, संसाधन > Google की बेहतर सेवाएं पर जाएं.
2. उपलब्ध सेवाओं की सूची में, Campaign Manager 360 API ढूंढें.
3. वर्शन ड्रॉपडाउन की मदद से, इस्तेमाल में मौजूद Campaign Manager 360 API वर्शन बदलें.
4. अपने बदलावों को सेव करने के लिए, ठीक है पर क्लिक करें.

C#

.NET के लिए Google API क्लाइंट लाइब्रेरी, Campaign Manager 360 API के हर वर्शन के लिए अलग-अलग बिल्ड उपलब्ध कराती है. इन्हें Nuget के ज़रिए डिस्ट्रिब्यूट किया जाता है.

इंस्टॉल करने के बारे में ज़्यादा जानकारी या डाउनलोड करने के अन्य विकल्पों के लिए, क्लाइंट लाइब्रेरी का दस्तावेज़ देखें.

Java

Java के लिए Google API क्लाइंट लाइब्रेरी, Campaign Manager 360 API के हर वर्शन के लिए अलग-अलग बिल्ड उपलब्ध कराती है. इन्हें मेवन के ज़रिए डिस्ट्रिब्यूट किया जाता है.

इंस्टॉल करने के बारे में ज़्यादा जानकारी या डाउनलोड करने के अन्य विकल्पों के लिए, क्लाइंट लाइब्रेरी का दस्तावेज़ देखें.

PHP

PHP के लिए Google API क्लाइंट लाइब्रेरी, Campaign Manager 360 API के हर वर्शन के लिए अलग-अलग बिल्ड उपलब्ध कराती है. इन्हें Packagist के ज़रिए डिस्ट्रिब्यूट किया जाता है.

इंस्टॉल करने के बारे में ज़्यादा जानकारी या डाउनलोड करने के अन्य विकल्पों के लिए, क्लाइंट लाइब्रेरी का दस्तावेज़ देखें.

Python

Python (v1/v2) के लिए Google API क्लाइंट लाइब्रेरी का हर बिल्ड, Campaign Manager 360 API के सभी वर्शन के साथ काम करता है. डिस्कवरी बिल्डर में, आर्ग्युमेंट के तौर पर दी गई वर्शन स्ट्रिंग को अपडेट करें:

discovery.build('dfareporting', 'v3.4', http=http)

इंस्टॉल करने के बारे में ज़्यादा जानकारी या डाउनलोड करने के अन्य विकल्पों के लिए, क्लाइंट लाइब्रेरी का दस्तावेज़ देखें.

Ruby

Ruby के लिए Google API क्लाइंट लाइब्रेरी का v0.8 और उससे पहले के वर्शन, Campaign Manager 360 API के सभी वर्शन के साथ काम करते हैं. बस service constructor के लिए आर्ग्युमेंट के तौर पर दी गई वर्शन स्ट्रिंग को अपडेट करें:

service = Google::APIClient::Service.new("dfareporting", "v3.4",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)

Ruby के लिए Google API क्लाइंट लाइब्रेरी v0.9+, Campaign Manager 360 API के हर वर्शन के लिए अलग-अलग बिल्ड उपलब्ध कराती है. इन्हें RubyGems के ज़रिए डिस्ट्रिब्यूट किया जाता है. इंस्टॉल करने के बारे में ज़्यादा जानकारी या डाउनलोड करने के अन्य विकल्पों के लिए, क्लाइंट लाइब्रेरी का दस्तावेज़ देखें.

चौथा चरण: पते के वर्शन में अंतर

हम अपनी नई रिलीज़ को पिछली रिलीज़ के साथ काम करने लायक बनाने की कोशिश करते हैं. इसका मतलब है कि एपीआई के वर्शन के बीच माइग्रेट करने के लिए, आपको अपने कोड में बदलाव करने की ज़रूरत नहीं होगी. अगर ऐसा नहीं हो पाता है, तो हम रिलीज़ नोट में उन बदलावों के बारे में बताते हैं जिनके लिए डेवलपर को कार्रवाई करनी होगी. इन्हें बड़े बदलाव भी कहा जाता है.

इस समय, आपको रिलीज़ नोट की समीक्षा करनी चाहिए. इसके लिए, उस वर्शन से शुरू करें जिससे आपने शुरुआत की थी (जिसकी जानकारी आपने पिछले सेक्शन में दी थी). इसके बाद, उस वर्शन तक की समीक्षा करें जिस पर आपको अपग्रेड करना है. रिलीज़ नोट के सेक्शन को इस तरह समझा जाना चाहिए:

• नई सुविधाएं - इसमें नई सुविधाएं जोड़ी गई हैं.
• बंद की गई सुविधाएं - एपीआई से हटाई गई सुविधाएं. जब यह सुविधा उपलब्ध होगी, तब इस सेक्शन में इसके काम करने का तरीका बताया जाएगा.
• पहले से मौजूद समस्याएं - ऐसे बदलाव जो न तो जोड़े गए हैं और न ही हटाए गए हैं. उदाहरण के लिए, इस सेक्शन में ऐसे फ़ील्ड या तरीके शामिल हो सकते हैं जिनका नाम बदला गया है या पुष्टि करने का लॉजिक बदला गया है.

नई सुविधाओं की सुविधाओं के लिए, कोड में बदलाव करने की ज़रूरत नहीं होगी. फ़िलहाल, इन सुविधाओं को अनदेखा किया जा सकता है. अगर आपको जोड़े गए किसी फ़ीचर को आज़माना है, तो इस सेक्शन पर बाद में वापस आएं.

दूसरी ओर, अगर आपको बंद होने वाले प्रॉडक्ट या पहले से मौजूद समस्याएं सेक्शन में बदलाव दिखते हैं, तो आपको कार्रवाई करनी पड़ सकती है. आपको अपने कोड में खोज कर यह पता लगाना चाहिए कि आपके ऐप्लिकेशन में, हटाई गई या बदली गई सुविधाओं का इस्तेमाल किया जा रहा है या नहीं. अगर ऐसा है, तो इन बदलावों को ठीक करने के लिए, आपको अपने कोड में अपडेट करने होंगे

अप-टू-डेट रहें

जैसा कि पहले बताया गया है, Campaign Manager 360 API की रिलीज़ और बंद होने की प्रक्रिया नियमित रूप से होती रहती है. नई रिलीज़, बंद होने वाले वर्शन, और बंद होने की तारीख से जुड़े अपडेट, इन चैनलों पर पोस्ट किए जाते हैं:

• Google Ads डेवलपर ब्लॉग (ईमेल सूचनाएं पाने के लिए सदस्यता लें)
• Campaign Manager 360 API फ़ोरम

हमारा सुझाव है कि एपीआई से जुड़ी नई खबरों के बारे में अप-टू-डेट रहने के लिए, इनमें से एक या उससे ज़्यादा चैनलों की सदस्यता लें.