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

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

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

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

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

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

API वर्शन	रिलीज़ की तारीख	सेवा बंद होने की तारीख	अपग्रेड करने के लिए गाइड
रिलीज़ किए गए वर्शन
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	19 अगस्त, 2026	अगस्त 2027	v25 से v25.1 पर अपग्रेड करना
v25.2	23 सितंबर, 2026	अगस्त 2027	v25.1 से v25.2 पर अपग्रेड करना
v26	14 अक्टूबर, 2026	नवंबर 2027	v25.2 से 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) के लिए, क्लाइंट लाइब्रेरी का दिया गया सबसे नया वर्शन काफ़ी है. माइनर रिलीज़ के लिए ज़रूरी क्लाइंट लाइब्रेरी वर्शन देखने के लिए, लिंक किया गया बदलावों का लॉग देखें.

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

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

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