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