बंद होने की प्रक्रिया और बंद होने की तारीख

Google Ads API में, किसी भी समय कई चालू मेजर वर्शन होते हैं. किसी वर्शन को सिर्फ़ तब बंद माना जाता है, जब उसे साफ़ तौर पर बंद के तौर पर मार्क किया गया हो. हम रिलीज़ और बंद होने की तारीखें पहले से पब्लिश करते हैं, ताकि आपको अपग्रेड करने का प्लान बनाने में मदद मिल सके. किसी वर्शन को बंद किए जाने के बाद, वह वर्शन उपलब्ध नहीं होता. वर्शन बनाने के लिए, यहां दिए गए कुछ मुख्य दिशा-निर्देशों को ध्यान में रखें:

• हम कोशिश करते हैं कि किसी भी समय ज़्यादा से ज़्यादा पांच मेजर वर्शन उपलब्ध हों.
• मेजर वर्शन करीब 12 महीने तक काम करते हैं. एपीआई के माइनर वर्शन की लाइफ़स्पैन को अलग से ट्रैक नहीं किया जाता. इसके बजाय, माइनर वर्शन के बंद होने की तारीख, उनके मेजर वर्शन के बंद होने की तारीख के जैसी ही होती है.
• हर माइनर वर्शन, अपने मेजर वर्शन को धीरे-धीरे अपडेट करता है.
• किसी खास मेजर वर्शन के लिए किए गए सभी एपीआई कॉल, हमेशा उससे जुड़े सबसे नए माइनर वर्शन पर जाते हैं. Google Ads API में, किसी खास माइनर वर्शन को कॉल करने की सुविधा काम नहीं करती.
• आपको हर साल ज़्यादा से ज़्यादा दो अपग्रेड करने होंगे. साथ ही, आपको क्रम से अपग्रेड करने की ज़रूरत नहीं है. उदाहरण के लिए, वर्शन (N) से सीधे वर्शन (N+2) पर अपग्रेड किया जा सकता है.
• अगर आपने हाल ही में Google Ads API का इस्तेमाल शुरू किया है, तो हमारा सुझाव है कि आप v26 से शुरुआत करें.

हमारी क्लाइंट लाइब्रेरी, किसी सेवा के उपलब्ध सभी वर्शन के साथ काम करती हैं. इसलिए, इस्तेमाल की गई सेवाओं के अलग-अलग वर्शन तय करके, धीरे-धीरे अपग्रेड किया जा सकता है.

आने-जाने का समय

इस टेबल में, हर उपलब्ध वर्शन के रिलीज़ होने और बंद होने की तारीखें दी गई हैं. साथ ही, आने वाले समय में रिलीज़ होने वाले वर्शन की अनुमानित तारीखें भी दी गई हैं. हमारा सुझाव है कि आप नए वर्शन के रिलीज़ होने के बाद, जल्द से जल्द उसमें अपग्रेड करें. अनुमानित तारीख का मतलब है कि उस महीने में किसी भी समय, इस सुविधा को बंद किया जा सकता है. साथ ही, तारीखों में बदलाव हो सकता है. ब्लॉग की सदस्यता लें, ताकि आपको एपीआई के वर्शन के बंद होने की सूचना के रिमाइंडर मिल सकें.

API वर्शन	रिलीज़ की तारीख	माइग्रेशन पूरा करने की समयसीमा	नुकसान पहुंचा सकने वाले बदलाव और अपग्रेड	सुविधाएं और अपडेट	प्रोटो डिफ़रेंस टेबल
रिलीज़ किए गए वर्शन
v23	28 जनवरी, 2026	फ़रवरी 2027	v23 में नुकसान पहुंचा सकने वाले बदलाव (अपग्रेड करने की गाइड)	v23 की सुविधाएं और अपडेट	v22 और v23 प्रोटो के बीच अंतर
v23.1	25 फ़रवरी, 2026	फ़रवरी 2027	कोई नहीं (माइनर रिलीज़)	v23.1 की सुविधाएं और अपडेट	v22 और v23 प्रोटो के बीच अंतर
v23.2	25 मार्च, 2026	फ़रवरी 2027	कोई नहीं (माइनर रिलीज़)	v23.2 की सुविधाएं और अपडेट	v22 और v23 प्रोटो के बीच अंतर
v23.3	24 जून, 2026	फ़रवरी 2027	कोई नहीं (माइनर रिलीज़)	वर्शन 23.3 की सुविधाएं और अपडेट	v22 और v23 प्रोटो के बीच अंतर
v24	22 अप्रैल, 2026	मई 2027	v24 में नुकसान पहुंचा सकने वाले बदलाव (अपग्रेड करने की गाइड)	v24 की सुविधाएं और अपडेट	v23 और v24 प्रोटो के बीच अंतर
v24.1	13 मई, 2026	मई 2027	कोई नहीं (माइनर रिलीज़)	v24.1 की सुविधाएं और अपडेट	v23 और v24 प्रोटो के बीच अंतर
v24.2	24 जून, 2026	जून 2027	कोई नहीं (माइनर रिलीज़)	v24.2 की सुविधाएं और अपडेट	v23 और v24 प्रोटो के बीच अंतर
v25	22 जुलाई, 2026	अगस्त 2027	v25 में नुकसान पहुंचा सकने वाले बदलाव (अपग्रेड करने की गाइड)	v25 की सुविधाएं और अपडेट	v24 और v25 प्रोटो के बीच अंतर
v25.1	19 अगस्त, 2026	अगस्त 2027	कोई नहीं (माइनर रिलीज़)	वर्शन 25.1 की सुविधाएं और अपडेट	v24 और v25 प्रोटो के बीच अंतर
v25.2	23 सितंबर, 2026	अगस्त 2027	कोई नहीं (माइनर रिलीज़)	v25.2 की सुविधाएं और अपडेट	v24 और v25 प्रोटो के बीच अंतर
v26 (नया वर्शन)	14 अक्टूबर, 2026	नवंबर 2027	v26 में नुकसान पहुंचा सकने वाले बदलाव (अपग्रेड करने की गाइड)	v26 की सुविधाएं और अपडेट	v25 और v26 प्रोटो के बीच अंतर
v26.1	28 अक्टूबर, 2026	नवंबर 2027	कोई नहीं (माइनर रिलीज़)	v26.1 की सुविधाएं और अपडेट	v25 और v26 प्रोटो के बीच अंतर
v26.2	11 नवंबर, 2026	नवंबर 2027	कोई नहीं (माइनर रिलीज़)	वर्शन 26.2 की सुविधाएं और अपडेट	v25 और v26 प्रोटो के बीच अंतर
आने वाले वर्शन
v26.3*	दिसंबर 2026	नवंबर 2027
v27	जनवरी 2027	फ़रवरी 2028
v27.1	फ़रवरी 2027	फ़रवरी 2028
v27.2	फ़रवरी 2027	फ़रवरी 2028
v27.3	मार्च 2027	फ़रवरी 2028
v27.4	मार्च 2027	फ़रवरी 2028
v28	अप्रैल 2027	मई 2028
v28.1	अप्रैल 2027	मई 2028
v28.2	मई 2027	मई 2028
v28.3	मई 2027	मई 2028
v28.4	जून 2027	मई 2028
v28.5	जून 2027	मई 2028
v29	जुलाई 2027	अगस्त 2028
v29.1	जुलाई 2027	अगस्त 2028
v29.2	अगस्त 2027	अगस्त 2028
v29.3	अगस्त 2027	अगस्त 2028
v29.4	सितंबर 2027	अगस्त 2028
v29.5	सितंबर 2027	अगस्त 2028
v30	अक्टूबर 2027	नवंबर 2028
v30.1	अक्टूबर 2027	नवंबर 2028
v30.2	नवंबर 2027	नवंबर 2028
v30.3*	दिसंबर 2027	नवंबर 2028

* छुट्टियों के सीज़न की वजह से, v26.3 और v30.3 को वैकल्पिक रिलीज़ के तौर पर तय किया गया है.

अपने प्रोजेक्ट में इस्तेमाल किए जा रहे वर्शन देखना

Google Cloud Console का इस्तेमाल करके, उन तरीकों और सेवाओं की सूची देखी जा सकती है जिन्हें आपके प्रोजेक्ट ने हाल ही में कॉल किया है:

1. Google Cloud Console में एपीआई और सेवाएं खोलें.
2. टेबल में, Google Ads API पर क्लिक करें.
3. मेट्रिक सब-टैब में, आपको हर ग्राफ़ पर अपने हाल ही के अनुरोध दिखेंगे. तरीके टेबल में जाकर, यह देखा जा सकता है कि आपने किन तरीकों के लिए अनुरोध भेजे हैं. तरीके के नाम में Google Ads API का वर्शन, सेवा, और तरीके का नाम शामिल होता है. जैसे, google.ads.googleads.v26.services.GoogleAdsService.Mutate.
4. (ज़रूरी नहीं) वह समयावधि चुनें जिसके लिए आपको अपने अनुरोध देखने हैं.

बंद होने और बंद किए जाने के बीच का अंतर

शब्द	बंद करना	सूर्यास्त
परिभाषा	किसी वर्शन को सिर्फ़ तब बंद किया गया माना जाता है, जब उसे साफ़ तौर पर बंद किया गया के तौर पर मार्क किया गया हो. Google Ads API के कई मेजर वर्शन, किसी भी समय चालू रहते हैं.	बंद किए गए वर्शन को इस्तेमाल नहीं किया जा सकता. इस वर्शन के बंद होने की तारीख या उसके बाद, इस वर्शन पर भेजे गए अनुरोध पूरे नहीं होंगे.
असर	बंद किए जा चुके वर्शन को तब तक इस्तेमाल किया जा सकता है, जब तक वे पूरी तरह से बंद नहीं हो जाते. हालांकि, बंद किए जा चुके वर्शन के रेफ़रंस को हाइलाइट नहीं किया जाता, ताकि यह दिखाया जा सके कि वे अब नए वर्शन नहीं हैं. हमारा सुझाव है कि आप जल्द से जल्द नए वर्शन पर अपग्रेड करें, ताकि आपको नई सुविधाओं का फ़ायदा मिल सके.	Google Ads API का इस्तेमाल करने के लिए, आपको बंद हो चुके वर्शन से तुरंत अपग्रेड करना होगा. हमारा सुझाव है कि आप अपग्रेड गाइड का इस्तेमाल करके, नए वर्शन पर अपग्रेड करें.
समय	बंद होने की तारीखें पहले ही पब्लिश कर दी जाती हैं. किसी वर्शन को बंद तब ही माना जाता है, जब उसे साफ़ तौर पर बंद के तौर पर मार्क किया गया हो.	हम किसी वर्शन को रिलीज़ होने के एक साल बाद बंद कर देते हैं.
एपीआई	बंद किए जा चुके वर्शन के लिए एपीआई एंडपॉइंट, अब भी सामान्य रूप से काम करते हैं. हमारी क्लाइंट लाइब्रेरी और REST का इस्तेमाल करके, हमारे एपीआई एंडपॉइंट ऐक्सेस किए जा सकते हैं. हालांकि, बंद किए जा चुके वर्शन में नई सुविधाएं नहीं जोड़ी जाती हैं.	बंद किए गए वर्शन के एपीआई एंडपॉइंट, बंद होने की तारीख के बाद काम करना बंद कर देते हैं. अगर आपने बंद हो चुके वर्शन के एपीआई एंडपॉइंट को ऐक्सेस करने की कोशिश की, तो Google Ads API गड़बड़ी का मैसेज दिखाएगा.
क्लाइंट लाइब्रेरी	हम क्लाइंट लाइब्रेरी को छोटा रखना चाहते हैं. इसलिए, एपीआई के बंद होने की तारीख के बाद, हम क्लाइंट लाइब्रेरी के नए वर्शन में, एपीआई के बंद हो चुके वर्शन शामिल नहीं करेंगे. इससे आपको अपने प्रोजेक्ट में हमारी क्लाइंट लाइब्रेरी शामिल करते समय, स्टोरेज बचाने में मदद मिलती है.	एपीआई के बंद किए गए वर्शन, क्लाइंट लाइब्रेरी के किसी भी नए वर्शन में काम नहीं करते.
सहायता	हम बंद किए जा चुके वर्शन के लिए, नियमित तौर पर सहायता उपलब्ध कराते हैं.	किसी वर्शन को बंद किए जाने के बाद, वह वर्शन उपलब्ध नहीं होता.

क्लाइंट लाइब्रेरी के इस्तेमाल किए जा सकने वाले वर्शन

इस टेबल में बताया गया है कि कौनसी क्लाइंट लाइब्रेरी, एपीआई के किस वर्शन के साथ काम करती है.

क्लाइंट लाइब्रेरी का लिस्ट किया गया कम से कम वर्शन, Google Ads API की मुख्य रिलीज़ (जैसे कि v26) के लिए काफ़ी है. माइनर रिलीज़ के लिए ज़रूरी क्लाइंट लाइब्रेरी वर्शन देखने के लिए, लिंक किया गया बदलावों का लॉग देखें.

सुविधाओं को बंद करना और उनमें बदलाव करना

इस पेज पर, एपीआई के वर्शन-लेवल की लाइफ़साइकल पर फ़ोकस किया गया है. हालांकि, अलग-अलग सुविधाओं के बंद होने (जैसे, स्मार्ट कैंपेन का बंद होना) और बिना वर्शन वाले वर्कफ़्लो में होने वाले बदलावों (जैसे, मांग बढ़ाने में मदद करने वाले कैंपेन के बजट से जुड़ी नई ज़रूरी शर्तें) को अलग से ट्रैक किया जाता है.

इस्तेमाल किए जा रहे वर्शन में, आने वाली सुविधाओं की लाइफ़साइकल और व्यवहार में होने वाले बदलावों को देखने के लिए, सुविधाओं के बंद होने और बिना वर्शन वाले बदलावों की गाइड देखें.