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