Search Ads 360 Reporting API, सिमेंटिक वर्शन का इस्तेमाल करता है.
इसके मेजर और माइनर वर्शन हैं, जिन्हें
vMAJOR_MINOR के फ़ॉर्मैट में तैयार किया गया है. उदाहरण के लिए, v0_0 पहला मेजर वर्शन है और v0_1 पहला माइनर वर्शन है. वर्शन नंबर का सफ़िक्स, वर्शन के टाइप के बारे में बताता है: मेजर वर्शन के लिए यह हमेशा शून्य होता है. वहीं, माइनर वर्शन के लिए यह हमेशा शून्य से ज़्यादा होता है.
मेजर वर्शन
मुख्य रिलीज़ में ऐसे बदलाव शामिल होते हैं जो नुकसान पहुंचा सकते हैं. इसका मतलब है कि ऐसे बदलाव जो पुराने सिस्टम के साथ काम नहीं करते.
हर मेजर वर्शन का एक अलग एंडपॉइंट होता है. उदाहरण के लिए:
https://searchads360.googleapis.com/v0 https://searchads360.googleapis.com/v1
एक मेजर वर्शन से दूसरे वर्शन में अपग्रेड करते समय, नए मेजर वर्शन वाले एंडपॉइंट पर स्विच करने से पहले, आपको अपना कोड बदलना पड़ सकता है.
अगर क्लाइंट लाइब्रेरी का इस्तेमाल किया जाता है, तो आपको सबसे नए वर्शन पर अपग्रेड करना होगा. नए मेजर वर्शन में, डेटा को दूसरी जगह भेजने से जुड़ी गाइड दी गई है. इससे, कोड में हुए नुकसान पहुंचाने वाले बदलावों को ठीक करने में मदद मिलती है.
नुकसान पहुंचा सकने वाले बदलावों के उदाहरण:
- किसी सेवा, इंटरफ़ेस, फ़ील्ड, मेथड या Enum वैल्यू को हटाना या उसका नाम बदलना.
- फ़ील्ड का टाइप बदलना.
- संसाधन के नाम का फ़ॉर्मैट बदलना.
- एचटीटीपी की परिभाषा में यूआरएल फ़ॉर्मैट बदलना.
- आउटपुट फ़ॉर्मैट बदलना. जैसे,
0को डिफ़ॉल्ट वैल्यू के तौर पर--में बदलना. - गड़बड़ी की वजह को A से B में बदलना.
माइनर वर्शन
छोटे वर्शन में, सिर्फ़ पुराने सिस्टम के साथ काम करने की सुविधा वाले बदलाव किए जाते हैं.
जब कोई माइनर वर्शन रिलीज़ होता है, तो पहले से इस्तेमाल किया जा रहा एंडपॉइंट अपने-आप अपडेट हो जाता है. इससे आपका कोड काम नहीं करेगा. अपनी मौजूदा क्लाइंट लाइब्रेरी का इस्तेमाल जारी रखा जा सकता है.
माइनर वर्शन में ऐसी नई सुविधाएं या अपडेट शामिल हैं जिनसे आपके मौजूदा कोड पर कोई असर नहीं पड़ता. अगर आप नई सुविधाओं का इस्तेमाल करना चाहते हैं, तो आपको अपने क्लाइंट लाइब्रेरी को नए वर्शन में अपग्रेड करना होगा.
डूबता सूरज
Search Ads 360 Reporting API के पुराने वर्शन के बंद होने के लिए शेड्यूल होने पर, हम searchads-api-announcements Google ग्रुप पर एक सूचना पोस्ट करते हैं.