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

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

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

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

टाइमटेबल

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

एपीआई वर्शनरिलीज़ की तारीखबंद करने की तारीखअपग्रेड करने के लिए गाइड
रिलीज़ किए गए वर्शन
v216 अगस्त, 2025अगस्त 2026 (अनुमानित)v20 से v21 पर अपग्रेड करना
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 जुलाई 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.v24.services.GoogleAdsService.Mutate.
  4. (ज़रूरी नहीं) वह समयावधि चुनें जिसके लिए आपको अपने अनुरोध देखने हैं.

वर्शन को बंद करने की तारीख तय करने और वर्शन को बंद करने में अंतर

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

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

Google Ads API का इस्तेमाल करने के लिए, वर्शन को बंद करने की तारीख तय किए गए वर्शन से तुरंत अपग्रेड करना ज़रूरी है.

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

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

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

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

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

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

Google Ads API के मेजर वर्शन (जैसे, v24) के लिए, क्लाइंट लाइब्रेरी का यहां दिया गया कम से कम वर्शन काफ़ी है. माइनर वर्शन के लिए, क्लाइंट लाइब्रेरी का ज़रूरी वर्शन देखने के लिए, लिंक किए गए बदलावों का इतिहास देखें.

Java

बदलावों का इतिहास

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

C#

बदलावों का इतिहास

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

PHP

बदलावों का इतिहास

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

Python

बदलावों का इतिहास

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

Ruby

बदलावों का इतिहास

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

Perl

बदलावों का इतिहास

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

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

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

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