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

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

  • हमारा मकसद है कि एक समय में ज़्यादा से ज़्यादा चार मेजर वर्शन उपलब्ध रहें.
  • मेजर वर्शन की लाइफ़साइकल करीब 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 से v23.1 पर अपग्रेड करना
v23.2 25 मार्च, 2026 फ़रवरी 2027 v23.1 से v23.2 पर अपग्रेड करना
v24 22 अप्रैल, 2026 मई 2027 v23.2 से v24 पर अपग्रेड करना
आने वाले वर्शन
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.v24.services.GoogleAdsService.Mutate.
  4. (ज़रूरी नहीं) वह समयावधि चुनें जिसके लिए आपको अनुरोध देखने हैं.

डिप्रेकेट होने और बंद होने में अंतर

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

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

Google Ads API का इस्तेमाल करने के लिए, आपको बंद हो चुके वर्शन से तुरंत अपग्रेड करना होगा.

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

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

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

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

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

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

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: -
v20 Min: 38.0.0
Max: 42.2.0

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: -
v20 Min: 23.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: -
v20 Min: 26.1.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: -
v20 Min: 27.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: -
v20 Min: 34.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: -
v20 Min: 27.0.0
Max: 32.0.0

बंद की गई सुविधाएं

आने वाले समय में बंद होने वाली सुविधाओं के बारे में सबसे पहले जानने के लिए, Google Ads डेवलपर ब्लॉग को नियमित तौर पर देखें.

यहां दी गई टेबल में, Google Ads API के लिए बंद की जाने वाली सुविधाओं के बारे में बताया गया है. हर सुविधा के बंद होने के बारे में ज़्यादा जानकारी, लिंक की गई ब्लॉग पोस्ट में देखी जा सकती है.

सुविधा ब्यौरा लागू होने की तारीख अतिरिक्त जानकारी
कस्टमर मैच की सुविधा के लिए सहायता से जुड़े बदलाव

जिन डेवलपर टोकन के लिए हाल ही में कस्टमर मैच के अनुरोध नहीं किए गए हैं उन्हें 1 अप्रैल, 2026 से अपने कस्टमर मैच के वर्कफ़्लो के लिए, Data Manager API का इस्तेमाल करना होगा.

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