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

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

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

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

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

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

API वर्शनरिलीज़ की तारीखमाइग्रेशन पूरा करने की समयसीमाअपग्रेड करने के लिए गाइड
रिलीज़ किए गए वर्शन
v2215 अक्टूबर, 2025अक्टूबर 2026v21 से 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.2 नवंबर 2026 नवंबर 2027  
v26.3* दिसंबर 2026 नवंबर 2027  
v27 जनवरी 2027 फ़रवरी 2028  
v27.1 फ़रवरी 2027 फ़रवरी 2028  
v27.2 फ़रवरी 2027 फ़रवरी 2028  
v27.3 मार्च 2027 फ़रवरी 2028  
v27.4 मार्च 2027 फ़रवरी 2028  
v28 अप्रैल 2027 मई 2028  
v28.1 अप्रैल 2027 मई 2028  
v28.2 मई 2027 मई 2028  
v28.3 मई 2027 मई 2028  
v28.4 जून 2027 मई 2028  
v28.5 जून 2027 मई 2028  
v29 जुलाई 2027 अगस्त 2028  
v29.1 जुलाई 2027 अगस्त 2028  
v29.2 अगस्त 2027 अगस्त 2028  
v29.3 अगस्त 2027 अगस्त 2028  
v29.4 सितंबर 2027 अगस्त 2028  
v29.5 सितंबर 2027 अगस्त 2028  
v30 अक्टूबर 2027 नवंबर 2028  
v30.1 अक्टूबर 2027 नवंबर 2028  
v30.2 नवंबर 2027 नवंबर 2028  
v30.3* दिसंबर 2027 नवंबर 2028  

* v26.3 और v30.3 को वैकल्पिक रिलीज़ के तौर पर तय किया गया है, क्योंकि ये छुट्टियों के सीज़न के साथ ओवरलैप होती हैं.

अपने प्रोजेक्ट में इस्तेमाल किए जा रहे वर्शन देखना

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

C#

बदलावों का लॉग

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

PHP

बदलावों का लॉग

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

Python

बदलावों का लॉग

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

Ruby

बदलावों का लॉग

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

Perl

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

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

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

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

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