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