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

किसी नए वर्शन के रिलीज़ होने पर, बंद किए जाने वाले वर्शन के लिए, बंद किए जाने की तारीख तय की जाती है. इसके बाद, वह वर्शन उपलब्ध नहीं होता. यहां कुछ अन्य दिशा-निर्देश दिए गए हैं:

• हमारा लक्ष्य है कि किसी भी समय ज़्यादा से ज़्यादा पांच मेजर वर्शन उपलब्ध हों.
• मेजर वर्शन की लाइफ़स्पैन करीब 12 महीने होती है. वहीं, माइनर वर्शन की लाइफ़स्पैन 10 महीने होती है.
• आपको हर साल ज़्यादा से ज़्यादा दो अपग्रेड करने होंगे. साथ ही, आपको क्रम से अपग्रेड करने की ज़रूरत नहीं है. उदाहरण के लिए, वर्शन (N) से सीधे वर्शन (N+2) पर अपग्रेड किया जा सकता है.

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

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

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

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

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	कोई नहीं (माइनर रिलीज़)	v25.1 की सुविधाएं और अपडेट	v24 और v25 प्रोटो के बीच अंतर
v25.2	23 सितंबर, 2026	अगस्त 2027	कोई नहीं (माइनर रिलीज़)	v25.2 की सुविधाएं और अपडेट	v24 और v25 प्रोटो के बीच अंतर
v26 (नया वर्शन)	14 अक्टूबर, 2026	नवंबर 2027	v26 में नुकसान पहुंचा सकने वाले बदलाव (अपग्रेड करने की गाइड)	v26 की सुविधाएं और अपडेट	v25 और v26 प्रोटो के बीच अंतर
आने वाले वर्शन
v26.1	अक्टूबर 2026	नवंबर 2027
v26.2	नवंबर 2026	नवंबर 2027
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 का इस्तेमाल करने के लिए, आपको बंद हो चुके वर्शन से तुरंत अपग्रेड करना होगा. हमारा सुझाव है कि आप अपग्रेड करने की गाइड का इस्तेमाल करके, नए वर्शन पर अपग्रेड करें.
समय	आम तौर पर, हम हर तीन से चार महीने में एक नया वर्शन रिलीज़ करते हैं. इसलिए, दिया गया वर्शन करीब तीन से चार महीने बाद काम नहीं करेगा.	हम किसी वर्शन को रिलीज़ होने के एक साल बाद बंद कर देते हैं.
एपीआई	बंद किए जा चुके वर्शन के लिए एपीआई एंडपॉइंट, अब भी सामान्य तरीके से काम करते हैं. हमारी क्लाइंट लाइब्रेरी और REST का इस्तेमाल करके, हमारे एपीआई एंडपॉइंट ऐक्सेस किए जा सकते हैं. हालांकि, बंद किए जा चुके वर्शन में नई सुविधाएं नहीं जोड़ी जाती हैं.	बंद किए जाने की तारीख के बाद, बंद किए गए वर्शन के लिए एपीआई एंडपॉइंट काम करना बंद कर देते हैं. अगर आपने बंद हो चुके वर्शन के एपीआई एंडपॉइंट को ऐक्सेस करने की कोशिश की, तो Google Ads API गड़बड़ी का मैसेज दिखाएगा.
क्लाइंट लाइब्रेरी	हम क्लाइंट लाइब्रेरी को छोटा रखने के लिए, एपीआई के बंद होने की तारीख के बाद, क्लाइंट लाइब्रेरी के नए वर्शन में एपीआई के बंद हो चुके वर्शन शामिल करना बंद कर देंगे. इससे आपको अपने प्रोजेक्ट में हमारी क्लाइंट लाइब्रेरी शामिल करते समय, स्टोरेज बचाने में मदद मिलती है. अहम जानकारी: एपीआई के बंद किए जा चुके वर्शन, क्लाइंट लाइब्रेरी के पहले रिलीज़ किए गए वर्शन में अब भी उपलब्ध हैं. एपीआई के वर्शन बंद होने तक, उन्हें डाउनलोड और इस्तेमाल किया जा सकता है.	बंद किए जाने की तारीख के बाद, क्लाइंट लाइब्रेरी के किसी भी नए वर्शन में, एपीआई के बंद किए गए वर्शन काम नहीं करते.
सहायता	हम बंद किए जा चुके वर्शन के लिए, नियमित तौर पर सहायता उपलब्ध कराते हैं.	किसी वर्शन को बंद किए जाने के बाद, वह वर्शन उपलब्ध नहीं होता.

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

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

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

Java

बदलावों का लॉग

Google Ads API	Java के लिए क्लाइंट लाइब्रेरी
v26	Min: 48.0.0 Max: -
v25	Min: 44.0.0 Max: -
v24	Min: 43.0.0 Max: -
v23	Min: 42.0.0 Max: -

C#

बदलावों का लॉग

Google Ads API	.NET के लिए क्लाइंट लाइब्रेरी
v26	Min: 27.5.0 Max: -
v25	Min: 26.1.0 Max: -
v24	Min: 25.3.0 Max: -
v23	Min: 25.1.0 Max: -

PHP

बदलावों का लॉग

Google Ads API	PHP के लिए क्लाइंट लाइब्रेरी
v26	Min: 35.2.0 Max: -
v25	Min: 33.6.0 Max: -
v24	Min: 33.3.0 Max: -
v23	Min: 32.2.0 Max: -

Python

बदलावों का लॉग

Google Ads API	Python के लिए क्लाइंट लाइब्रेरी
v26	Min: 34.0.0 Max: -
v25	Min: 31.2.0 Max: -
v24	Min: 30.1.0 Max: -
v23	Min: 29.2.0 Max: -

Ruby

बदलावों का लॉग

Google Ads API	Ruby के लिए क्लाइंट लाइब्रेरी
v26	Min: 46.0.0 Max: -
v25	Min: 43.0.0 Max: -
v24	Min: 40.0.0 Max: -
v23	Min: 38.0.0 Max: -

Perl

बदलावों का लॉग

Google Ads API	Perl के लिए क्लाइंट लाइब्रेरी
v26	Min: 36.0.0 Max: -
v25	Min: 33.0.0 Max: -
v24	Min: 32.0.0 Max: -
v23	Min: 31.0.0 Max: -

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

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

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