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

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

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

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

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

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

API वर्शन	रिलीज़ की तारीख	बंद होने की तारीख	बंद होने की तारीख	अपग्रेड करने के लिए गाइड
v21	6 अगस्त, 2025			v20 से v21 में अपग्रेड करना
v20.1	6 अगस्त, 2025		जून 2026 (अनुमानित)	v19 से v20 में अपग्रेड करना
v20	4 जून, 2025		जून 2026 (अनुमानित)	v19 से v20 में अपग्रेड करना
v19.2	6 अगस्त, 2025		फ़रवरी 2026 (अनुमानित)	v18 से v19 में अपग्रेड करना
v19.1	16 अप्रैल, 2025		फ़रवरी 2026 (अनुमानित)	v18 से v19 में अपग्रेड करना
v19	26 फ़रवरी, 2025		फ़रवरी 2026 (अनुमानित)	v18 से v19 में अपग्रेड करना
v18	16 अक्टूबर, 2024	जून 2025	20 अगस्त, 2025

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

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

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

बंद होने और सेवा बंद होने में अंतर

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

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

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

Java

Google Ads API	Java के लिए क्लाइंट लाइब्रेरी
v21	Min: 39.0.0 Max: -
v20	Min: 38.0.0 Max: -
v19	Min: 36.0.0 Max: -

C#

Google Ads API	.NET के लिए क्लाइंट लाइब्रेरी
v21	Min: 24.0.0 Max: -
v20	Min: 23.0.0 Max: -
v19	Min: 22.1.0 Max: -
v18	Min: 21.1.0 Max: 23.0.0

PHP

Google Ads API	PHP के लिए क्लाइंट लाइब्रेरी
v21	Min: 31.0.0 Max: -
v20	Min: 28.0.0 Max: -
v19	Min: 26.1.0 Max: -
v18	Min: 25.0.0 Max: 30.0.0

Python

Google Ads API	Python के लिए क्लाइंट लाइब्रेरी
v21	Min: 28.0.0 Max: -
v20	Min: 27.0.0 Max: -
v19	Min: 25.2.0 Max: -

Ruby

Google Ads API	Ruby के लिए क्लाइंट लाइब्रेरी
v21	Min: 35.0.0 Max: -
v20	Min: 34.0.0 Max: -
v19	Min: 32.0.0 Max: -
v18	Min: 31.0.0 Max: -

Perl

Google Ads API	Perl के लिए क्लाइंट लाइब्रेरी
v21	Min: 28.0.0 Max: -
v20	Min: 27.0.0 Max: -
v19	Min: 26.0.0 Max: -
v18	Min: 25.0.1 Max: 28.0.0

बंद की गई सुविधाएं

आने वाले समय में बंद होने वाली सुविधाओं के बारे में सबसे पहले जानने के लिए, Google Ads डेवलपर ब्लॉग को नियमित तौर पर देखें.

यहां दी गई टेबल में, Google Ads API के लिए बंद की जाने वाली सुविधाओं के बारे में बताया गया है. हर सुविधा को बंद करने के बारे में ज़्यादा जानकारी, लिंक किए गए ब्लॉग पोस्ट में देखी जा सकती है.

सुविधा	ब्यौरा	लागू होने की तारीख	और जानकारी
ऐप्लिकेशन कैंपेन की परफ़ॉर्मेंस पर असर डालने वाला कन्वर्ज़न एनवायरमेंट	हम 30 सितंबर, 2025 से, बिडिंग मॉडल में धीरे-धीरे बदलाव करना शुरू करेंगे. इससे वे इंपोर्ट किए गए कन्वर्ज़न में शामिल कन्वर्ज़न एनवायरमेंट डेटा का इस्तेमाल करके, कैंपेन की परफ़ॉर्मेंस को ऑप्टिमाइज़ कर पाएंगे.	3 अक्टूबर, 2025	ज़्यादा जानकारी के लिए, हमारी ब्लॉग पोस्ट देखें.
कन्वर्ज़न में `gclid` और `gbraid`, दोनों वैल्यू शामिल हो सकती हैं.	अगर `gclid` और `gbraid`, दोनों फ़ील्ड सेट किए गए हैं, तो इंपोर्ट किए गए कन्वर्ज़न में 3 अक्टूबर, 2025 से `VALUE_MUST_BE_UNSET` गड़बड़ी नहीं दिखेगी.	3 अक्टूबर, 2025	ज़्यादा जानकारी के लिए, हमारी ब्लॉग पोस्ट देखें.