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

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

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

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

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

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

API वर्शनरिलीज़ की तारीखसुविधा के बंद होने की तारीखअपग्रेड करने के लिए गाइड
रिलीज़ किए गए वर्शन
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 25 फ़रवरी, 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.1.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.1.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.2.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.2.0
Max: -
v22 Min: 28.1.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

Ruby

Ruby के लिए क्लाइंट लाइब्रेरी
v23 Min: 38.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: 31.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 के लिए बंद की जाने वाली सुविधाओं के बारे में बताया गया है. हर सुविधा के बंद होने के बारे में ज़्यादा जानकारी के लिए, लिंक की गई ब्लॉग पोस्ट पढ़ें.

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