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

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

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

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

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

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

API वर्शनरिलीज़ की तारीखसुविधा के बंद होने की तारीखअपग्रेड करने के लिए गाइड
रिलीज़ किए गए वर्शन
v1926 फ़रवरी, 2025 11 फ़रवरी, 2026
v19.116 अप्रैल, 2025 11 फ़रवरी, 2026
v19.26 अगस्त, 2025 11 फ़रवरी, 2026
v204 जून, 2025जून 2026 (अनुमानित)v19 से v20 में अपग्रेड करना
v20.16 अगस्त, 2025जून 2026 (अनुमानित)v19 से v20 में अपग्रेड करना
v216 अगस्त, 2025अगस्त 2026 (अनुमानित)v20 से v21 में अपग्रेड करना
v2215 अक्टूबर, 2025अक्टूबर 2026 (अनुमानित)v21 से v22 में अपग्रेड करना
v2328 जनवरी, 2026फ़रवरी 2027v22 से v23 में अपग्रेड करना
आने वाले वर्शन
v23.1 फ़रवरी 2026 फ़रवरी 2027  
v23.2 25 मार्च, 2026 फ़रवरी 2027  
v24 अप्रैल 2026 मई 2027  
v24.1 मई 2026 मई 2027  
v24.2 जून 2026 मई 2027  
v25 जुलाई 2026 अगस्त 2027  
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.v23.services.GoogleAdsService.Mutate.
  4. (ज़रूरी नहीं) वह समयावधि चुनें जिसके लिए आपको अनुरोध देखने हैं.

डेटा के इस्तेमाल पर रोक लगने और सेवा बंद होने के बीच अंतर

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

हमारा सुझाव है कि नई सुविधाओं का फ़ायदा पाने के लिए, जल्द से जल्द नए वर्शन पर अपग्रेड करें.

Google Ads API का इस्तेमाल करने के लिए, आपको बंद हो चुके वर्शन से तुरंत अपग्रेड करना होगा.

हमारा सुझाव है कि आप अपग्रेड करने से जुड़ी गाइड का इस्तेमाल करके, नए वर्शन पर अपग्रेड करें.

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

क्लाइंट लाइब्रेरी, REST वगैरह का इस्तेमाल करके, हमारे एपीआई एंडपॉइंट ऐक्सेस किए जा सकते हैं. हालांकि, बंद किए गए वर्शन में नई सुविधाएं नहीं जोड़ी जाती हैं.

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

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

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

Java

Java के लिए क्लाइंट लाइब्रेरी
v23 Min: 42.0.0
Max: -
v22 Min: 41.1.0
Max: -
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: -

C#

.NET के लिए क्लाइंट लाइब्रेरी
v23 Min: 25.0.0
Max: -
v22 Min: 24.1.0
Max: -
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -

PHP

PHP के लिए क्लाइंट लाइब्रेरी
v23 Min: 32.1.0
Max: -
v22 Min: 31.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 26.1.0
Max: -

Python

Python के लिए क्लाइंट लाइब्रेरी
v23 Min: 29.0.0
Max: -
v22 Min: 28.1.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

Ruby

Ruby के लिए क्लाइंट लाइब्रेरी
v23 Min: 37.0.0
Max: -
v22 Min: 36.0.0
Max: -
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -

Perl

Perl के लिए क्लाइंट लाइब्रेरी
v23 Min: 30.0.0
Max: -
v22 Min: 29.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

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

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

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

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