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

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

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

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

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

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

API वर्शनरिलीज़ की तारीखमाइग्रेशन पूरा करने की समयसीमाअपग्रेड करने के लिए गाइड
रिलीज़ किए गए वर्शन
v2215 अक्टूबर, 2025अक्टूबर 2026 (अनुमानित)v21 से v22 में अपग्रेड करना
v2328 जनवरी, 2026फ़रवरी 2027v22 से 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) के लिए, क्लाइंट लाइब्रेरी का दिया गया सबसे नया वर्शन काफ़ी है. माइनर रिलीज़ के लिए, क्लाइंट लाइब्रेरी का ज़रूरी वर्शन देखने के लिए, लिंक किए गए बदलाव के लॉग पर जाएं.

Java

बदलाव की जानकारी

Java के लिए क्लाइंट लाइब्रेरी
v25 Min: 44.0.0
Max: -
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -
v22 Min: 41.0.0
Max: -

C#

बदलाव की जानकारी

.NET के लिए क्लाइंट लाइब्रेरी
v25 Min: 26.1.0
Max: -
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -
v22 Min: 24.1.0
Max: -

PHP

बदलाव की जानकारी

PHP के लिए क्लाइंट लाइब्रेरी
v25 Min: 33.6.0
Max: -
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -
v22 Min: 31.0.0
Max: -

Python

बदलाव की जानकारी

Python के लिए क्लाइंट लाइब्रेरी
v25 Min: 31.2.0
Max: -
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -
v22 Min: 28.1.0
Max: -

Ruby

बदलाव की जानकारी

Ruby के लिए क्लाइंट लाइब्रेरी
v25 Min: 43.0.0
Max: -
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -
v22 Min: 36.0.0
Max: -

Perl

बदलाव की जानकारी

Perl के लिए क्लाइंट लाइब्रेरी
v25 Min: 33.0.0
Max: -
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -
v22 Min: 29.0.0
Max: -

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

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

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