सिमैंटिक वर्शन
Google Ads API सेमैंटिक वर्शन का पालन करता है, जहां इसका मेजर और माइनर वर्शन होता है. वर्शन का फ़ॉर्मैट MAJOR.MINOR या
vMAJOR_MINOR है. उदाहरण के लिए, v16_0 एक मेजर वर्शन है, जबकि
v16_1 एक माइनर वर्शन है.
पिछले वर्शन की प्रॉडक्ट की जानकारी देखें.
मेजर वर्शन
मुख्य रिलीज़ वर्शन में कुछ ऐसे बदलाव होते हैं जो काम नहीं करते और पुराने सिस्टम के साथ काम नहीं करते.
वर्शन vX_0 के साथ शून्य पर खत्म होगा, जहां X मेजर वर्शन नंबर है.
हर मेजर वर्शन का अलग एंडपॉइंट होता है. यह यूआरएल का एक उदाहरण है, जहां
X एक मेजर वर्शन नंबर है.
https://googleads.googleapis.com/vX
अगर पुराने मेजर वर्शन से अपग्रेड किया जा रहा है, तो नए मेजर वर्शन एंडपॉइंट पर स्विच करने के दौरान, आपके कोड में बदलाव करना पड़ सकता है. अगर हमारी क्लाइंट लाइब्रेरी का इस्तेमाल किया जा रहा है, तो सबसे नए वर्शन पर अपग्रेड करें. मेजर वर्शन रिलीज़ होने पर, हम एक माइग्रेशन गाइड उपलब्ध कराएंगे. इससे आपको अपने कोड में हुए नुकसान पहुंचाने वाले बदलावों को ठीक करने में मदद मिलेगी.
नुकसान पहुंचा सकने वाले बदलावों के उदाहरण:
- किसी सेवा, इंटरफ़ेस, फ़ील्ड, तरीके या enum वैल्यू को हटाना या उसका नाम बदलना.
- फ़ील्ड का टाइप बदलना.
- संसाधन के नाम का फ़ॉर्मैट बदलना.
- एचटीटीपी की परिभाषा में यूआरएल फ़ॉर्मैट को बदलना.
- आउटपुट फ़ॉर्मैट बदलना, जैसे कि डिफ़ॉल्ट वैल्यू के तौर पर
0से--में बदलना. - गड़बड़ी की वजह को A से B में बदलना.
माइनर वर्शन
माइनर वर्शन में, सिर्फ़ पुराने सिस्टम के साथ काम करने वाले बदलाव किए जाते हैं. माइनर वर्शन के लिए, vMAJOR_MINOR की MINOR संख्या शून्य से बड़ी होगी.
माइनर वर्शन रिलीज़ होने पर, पहले से इस्तेमाल किया जा रहा एंडपॉइंट अपने-आप अपडेट हो जाएगा. इससे आपका कोड काम नहीं करेगा. अपनी मौजूदा क्लाइंट लाइब्रेरी का इस्तेमाल जारी रखा जा सकता है.
माइनर वर्शन में ऐसी नई सुविधाएं या अपडेट शामिल हैं जिनसे आपके मौजूदा कोड पर कोई असर नहीं पड़ता. अगर आपको इन नई सुविधाओं का इस्तेमाल करना है, तो अपनी क्लाइंट लाइब्रेरी को सबसे नए वर्शन में अपग्रेड करें.
डूबता सूरज
समय-समय पर, Google Ads API के पुराने वर्शन बंद हो जाएंगे. जब कोई वर्शन बंद होने वाला होगा, तब हम डेवलपर ब्लॉग पर सूचनाएं पोस्ट करेंगे. रोक लगाने के शेड्यूल को आगे बंद करने की तारीखों के साथ अपडेट किया गया है.