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