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

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. Maven 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 Client Library के वर्शन की जानकारी, 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

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

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

अगर आपका वर्शन सूची में शामिल है, तो बंद होने की तारीख और सेवा बंद होने की तारीख कॉलम देखें:

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

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

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

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

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 के हर वर्शन के लिए अलग-अलग बिल्ड उपलब्ध कराती है. इन्हें Maven के ज़रिए डिस्ट्रिब्यूट किया जाता है. क्लाइंट लाइब्रेरी को उस एपीआई वर्शन के हिसाब से अपडेट करें जिसका आपको इस्तेमाल करना है.

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

PHP

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

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

Python

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

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

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

Ruby

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

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 API के हर वर्शन के लिए अलग-अलग बिल्ड उपलब्ध कराती है. इन्हें RubyGems के ज़रिए डिस्ट्रिब्यूट किया जाता है. क्लाइंट लाइब्रेरी को उस एपीआई वर्शन के हिसाब से अपडेट करें जिसका आपको इस्तेमाल करना है. इंस्टॉल करने के बारे में ज़्यादा जानने या डाउनलोड करने के अन्य विकल्प देखने के लिए, क्लाइंट लाइब्रेरी का दस्तावेज़ देखें.

REST

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

उदाहरण के लिए, v4 से v5 पर माइग्रेट करते समय, आपको बुनियादी यूआरएल को इससे बदलना होगा:

https://dfareporting.googleapis.com/dfareporting/v4/...

को:

https://dfareporting.googleapis.com/dfareporting/v5/...

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

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

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

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

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

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

एपीआई रिलीज़, बंद होने, और बंद किए जाने के बारे में सबसे पहले जानने के लिए, Google Ads डेवलपर ब्लॉग को नियमित रूप से देखें.