सिमैंटिक वर्शनिंग
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 के पुराने वर्शन बंद कर दिए जाते हैं और बाद में उन्हें हटा दिया जाता है:
- बंद कर दिया गया है: जब कोई मेजर वर्शन (जैसे,
v26) रिलीज़ किया जाता है, तो सभी पुराने मेजर वर्शन को 'बंद कर दिया गया है' के तौर पर मार्क कर दिया जाता है. बंद किए जा चुके वर्शन के लिए किए गए एपीआई कॉल, उनके बंद होने की तारीख तक काम करते रहेंगे. साथ ही, मौजूदा क्लाइंट लाइब्रेरी रिलीज़, उन्हें सपोर्ट करती रहेंगी. हालांकि, क्लाइंट लाइब्रेरी की अगली रिलीज़ में, बंद किए जा चुके एपीआई वर्शन शामिल नहीं किए जाएंगे, ताकि पैकेज का साइज़ कम किया जा सके. - बंद होना: किसी वर्शन को बंद करने की तारीख पर, उसे बंद कर दिया जाता है. साथ ही, उसके एंडपॉइंट पर किए जाने वाले सभी एपीआई कॉल काम नहीं करते.
हम किसी वर्शन के बंद होने से पहले, डेवलपर ब्लॉग पर सूचनाएं पोस्ट करते हैं. चालू, बंद, और बंद होने के लिए शेड्यूल की गई तारीखों के लिए, बंद होने और बंद होने के शेड्यूल की जांच करें.