Search Ads 360 Reporting API में सेमैंटिक वर्शन का इस्तेमाल होता है.
मेजर और माइनर वर्शन, इस तरह फ़ॉर्मैट किए जाते हैं
vMAJOR_MINOR
. उदाहरण के लिए, v0_0
पहला मेजर वर्शन और v0_1
पहला माइनर वर्शन. इसका सफ़िक्स
वर्शन नंबर वर्शन टाइप दिखाता है: मेजर वर्शन के लिए, यह हमेशा शून्य होता है,
और छोटे वर्शन के लिए यह हमेशा शून्य से ज़्यादा होता है.
मेजर वर्शन
मुख्य रिलीज़ में नुकसान पहुंचाने वाले बदलाव होते हैं, यानी ऐसे बदलाव होते हैं जो पुराने सिस्टम के साथ काम करने की सुविधा.
हर मेजर वर्शन का एक अलग एंडपॉइंट होता है, उदाहरण के लिए:
https://searchads360.googleapis.com/v0 https://searchads360.googleapis.com/v1
एक मेजर वर्शन से दूसरे में अपग्रेड करते समय, आपको कोड जोड़ना होगा.
अगर क्लाइंट लाइब्रेरी का इस्तेमाल किया जाता है, तो आपको सबसे नए वर्शन पर अपग्रेड करना होगा. नए मेजर वर्शन से डेटा को दूसरी जगह भेजने से जुड़ी गाइड देखें.
नुकसान पहुंचा सकने वाले बदलावों के उदाहरण:
- किसी सेवा, इंटरफ़ेस, फ़ील्ड, तरीके या ईनम वैल्यू को हटाना या उसका नाम बदलना.
- फ़ील्ड का टाइप बदलना.
- संसाधन के नाम का फ़ॉर्मैट बदलना.
- एचटीटीपी डेफ़िनिशन में यूआरएल का फ़ॉर्मैट बदलना.
- आउटपुट फ़ॉर्मैट बदलना, जैसे कि
0
को डिफ़ॉल्ट वैल्यू के तौर पर--
में बदलना. - गड़बड़ी की वजह को A से B में बदलकर.
माइनर वर्शन
माइनर वर्शन में सिर्फ़ पुराने सिस्टम के साथ काम करने वाले बदलाव ही शामिल किए जाते हैं.
जब कोई माइनर वर्शन रिलीज़ किया जाता है, तो पहले से इस्तेमाल किया जा रहा एंडपॉइंट यह होता है अपने-आप अपडेट होता है. इससे आपका कोड नहीं टूटता. जारी रखने के लिए, अपनी मौजूदा क्लाइंट लाइब्रेरी का इस्तेमाल करने के लिए.
माइनर वर्शन में ऐसी नई सुविधाएं या अपडेट शामिल होते हैं जो मौजूदा वर्शन पर असर नहीं डालते कोड. अगर आपको नई सुविधाएं इस्तेमाल करनी हैं, तो आपको क्लाइंट लाइब्रेरी को नए वर्शन में अपडेट करें वर्शन है.
डूबता सूरज
जब Search Ads 360 Reporting API का पुराना वर्शन बंद होने वाला है, तब हम searchads-api-announcements Google ग्रुप पर सूचना पोस्ट करना.