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

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

  • हमारा मकसद है कि किसी भी समय, ज़्यादा से ज़्यादा पांच मेजर वर्शन उपलब्ध रहें.
  • मेजर वर्शन की लाइफ़स्पैन करीब 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 19 अगस्त, 2026 अगस्त 2027 v25 से v25.1 पर अपग्रेड करना
v25.2 23 सितंबर, 2026 अगस्त 2027 v25.1 से v25.2 पर अपग्रेड करना
आने वाले वर्शन
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: 32.0.0

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: -

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

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

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