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

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

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

चरण 1: तय करें कि किस वर्शन का इस्तेमाल किया जा रहा है

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

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

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

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

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

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

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

C#

.NET के लिए Google API क्लाइंट लाइब्रेरी के वर्शन की जानकारी, इन जगहों पर उपलब्ध है:

1. न्यूगेट पैकेज के नाम और सेवा के नेमस्पेस में शामिल किया गया है.

   Google.Apis.Dfareporting.v3_4

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

   Console.WriteLine(DfareportingService.Version);

Java

Java के लिए Google API क्लाइंट लाइब्रेरी के वर्शन की जानकारी, इन जगहों पर उपलब्ध है:

1. Maven आर्टफ़ैक्ट आईडी में बताया गया है.

   <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 के लिए Google API क्लाइंट लाइब्रेरी, वर्शन में नहीं है. इस्तेमाल किए जाने वाले एपीआई का वर्शन, डिस्कवरी बिल्डर में आर्ग्युमेंट के तौर पर दिया जाता है:

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

Ruby

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

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

Ruby वर्शन >= 0.9 के लिए Google API क्लाइंट लाइब्रेरी का वर्शन, सेवा के नेमस्पेस में दिखाया गया है:

Google.Apis.DfareportingV3_4

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

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

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

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

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

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

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

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

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

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

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

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

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

C#

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

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

Java

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

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

PHP

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

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

Python

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

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

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

Ruby

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

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

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

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

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

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

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

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

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

हमसे जुड़े रहें

जैसा कि पहले बताया गया है, Campaign Manager 360 एपीआई के रिलीज़ और बंद होने की प्रोसेस नियमित तौर पर होती हैं. नई रिलीज़, समर्थन नहीं करने या बंद होने के बारे में अपडेट नीचे दिए गए चैनलों पर पोस्ट किए गए हैं:

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

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