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