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 ग्रुप पर एक सूचना पोस्ट करते हैं.