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