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

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

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

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

टाइमटेबल

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

एपीआई वर्शन	रिलीज़ की तारीख	बंद करने की तारीख	अपग्रेड करने के लिए गाइड
रिलीज़ किए गए वर्शन
v21	6 अगस्त, 2025	अगस्त 2026 (अनुमानित)	v20 से v21 पर अपग्रेड करना
v22	15 अक्टूबर, 2025	अक्टूबर 2026 (अनुमानित)	v21 से v22 पर अपग्रेड करना
v23	28 जनवरी, 2026	फ़रवरी 2027	v22 से v23 पर अपग्रेड करना
v23.1	25 फ़रवरी, 2026	फ़रवरी 2027	v23 से v23.1 पर अपग्रेड करना
v23.2	25 मार्च, 2026	फ़रवरी 2027	v23.1 से v23.2 पर अपग्रेड करना
v24	22 अप्रैल, 2026	मई 2027	v23.2 से v24 पर अपग्रेड करना
v24.1	13 मई, 2026	मई 2027	v24 से v24.1 पर अपग्रेड करना
v24.2	24 जून, 2026	जून 2027	v24.1 से v24.2 पर अपग्रेड करना
v25	22 जुलाई, 2026	अगस्त 2027	v24.2 से v25 पर अपग्रेड करना
आने वाले वर्शन
v25.1	अगस्त 2026	अगस्त 2027
v25.2	सितंबर 2026	अगस्त 2027
v26	अक्टूबर 2026	नवंबर 2027
v26.1*	नवंबर 2026	नवंबर 2027

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

यह देखना कि आपका प्रोजेक्ट किन वर्शन का इस्तेमाल कर रहा है

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

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

वर्शन को बंद करने और उसके लिए सहायता बंद करने में अंतर

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

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

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

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

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

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

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