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