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