नए वर्शन के रिलीज़ होने के बाद, बंद किए गए वर्शन के लिए बंद होने की तारीख तय की जाती है. इस तारीख के बाद, वह वर्शन उपलब्ध नहीं होता. यहां दिए गए अन्य दिशा-निर्देशों का पालन करें:
- हमारा मकसद है कि किसी भी समय, ज़्यादा से ज़्यादा चार मेजर वर्शन उपलब्ध रहें.
- मेजर वर्शन की लाइफ़साइकल करीब 12 महीने होती है. वहीं, माइनर वर्शन की लाइफ़साइकल 10 महीने होती है.
- आपको हर साल ज़्यादा से ज़्यादा दो बार अपग्रेड करना होगा. साथ ही, आपको क्रम से अपग्रेड करने की ज़रूरत नहीं है. उदाहरण के लिए, वर्शन (N) से सीधे वर्शन (N+2) पर अपग्रेड किया जा सकता है.
- सभी क्लाइंट लाइब्रेरी के नए वर्शन को रिलीज़ करने की तारीख और बंद किए जाने वाले वर्शन की तारीख के बीच कम से कम 20 हफ़्तों का अंतर होना चाहिए.
हमारी क्लाइंट लाइब्रेरी, किसी सेवा के उपलब्ध सभी वर्शन के साथ काम करती हैं. इसलिए, इस्तेमाल की गई सेवाओं के अलग-अलग वर्शन तय करके, धीरे-धीरे अपग्रेड किया जा सकता है.
आने-जाने का समय
यहां दी गई टेबल में, हर उपलब्ध वर्शन के लिए बंद होने की तारीखों के बारे में बताया गया है. साथ ही, आने वाले समय में रिलीज़ होने वाले वर्शन की अनुमानित तारीखों के बारे में भी बताया गया है. हमारा सुझाव है कि आप नए वर्शन के रिलीज़ होने के बाद, जल्द से जल्द उसे अपग्रेड करें. अनुमानित तारीख का मतलब है कि उस महीने में किसी भी समय सेवा बंद की जा सकती है. साथ ही, तारीखों में बदलाव भी हो सकता है. एपीआई वर्शन को बंद करने से जुड़े एलान के रिमाइंडर पाने के लिए, ब्लॉग की सदस्यता लें.
| API वर्शन | रिलीज़ की तारीख | बंद होने की तारीख | अपग्रेड करने के लिए गाइड |
|---|---|---|---|
| रिलीज़ किए गए वर्शन | |||
| v19 | 26 फ़रवरी, 2025 | 11 फ़रवरी, 2026 | |
| v19.1 | 16 अप्रैल, 2025 | 11 फ़रवरी, 2026 | |
| v19.2 | 6 अगस्त, 2025 | 11 फ़रवरी, 2026 | |
| v20 | 4 जून, 2025 | जून 2026 (अनुमानित) | v19 से v20 में अपग्रेड करना |
| v20.1 | 6 अगस्त, 2025 | जून 2026 (अनुमानित) | v19 से v20 में अपग्रेड करना |
| v21 | 6 अगस्त, 2025 | अगस्त 2026 (अनुमानित) | v20 से v21 में अपग्रेड करना |
| v22 | 15 अक्टूबर, 2025 | अक्टूबर 2026 (अनुमानित) | v21 से v22 में अपग्रेड करना |
| v23 | 28 जनवरी, 2026 | फ़रवरी 2027 | v22 से v23 में अपग्रेड करना |
| आने वाले वर्शन | |||
| v23.1 | फ़रवरी 2026 | फ़रवरी 2027 | |
| v23.2 | 25 मार्च, 2026 | फ़रवरी 2027 | |
| v24 | अप्रैल 2026 | मई 2027 | |
| 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 का इस्तेमाल करके, उन तरीकों और सेवाओं की सूची देखी जा सकती है जिन्हें आपके प्रोजेक्ट ने हाल ही में कॉल किया है:
- Google Cloud Console में एपीआई और सेवाएं खोलें.
- टेबल में, Google Ads API पर क्लिक करें.
- आंकड़े सब-टैब पर, आपको हर ग्राफ़ में अपने हाल ही के अनुरोध दिखेंगे. तरीके टेबल में जाकर, यह देखा जा सकता है कि आपने किन तरीकों से अनुरोध भेजे हैं. तरीके के नाम में Google Ads API का वर्शन, सेवा, और तरीके का नाम शामिल होता है. जैसे,
google.ads.googleads.v23.services.GoogleAdsService.Mutate. - (ज़रूरी नहीं) वह समयावधि चुनें जिसके लिए आपको अनुरोध देखने हैं.
डेटा के इस्तेमाल पर रोक लगाने और सेवा बंद करने के बीच अंतर
| शब्द | बंद की गई सेवाएं/सुविधाएं | सूर्यास्त |
|---|---|---|
| परिभाषा | पुराना वर्शन, सबसे नया वर्शन नहीं होता. नया वर्शन रिलीज़ होने के बाद, पिछले सभी वर्शन को पुराना मार्क कर दिया जाएगा. | बंद किए गए वर्शन का अब इस्तेमाल नहीं किया जा सकता. इस वर्शन पर भेजे गए अनुरोध, बंद होने की तारीख को या उसके बाद पूरे नहीं किए जा सकेंगे. |
| नतीजा | बंद किए गए वर्शन का इस्तेमाल तब तक किया जा सकता है, जब तक उन्हें बंद नहीं कर दिया जाता. हालांकि, बंद किए गए वर्शन के रेफ़रंस को डी-हाइलाइट कर दिया जाता है, ताकि यह पता चल सके कि वे अब नया वर्शन नहीं हैं.
हमारा सुझाव है कि नई सुविधाओं का फ़ायदा पाने के लिए, जल्द से जल्द नए वर्शन पर अपग्रेड करें. |
Google Ads API का इस्तेमाल करने के लिए, आपको बंद हो चुके वर्शन से तुरंत अपग्रेड करना होगा.
हमारा सुझाव है कि आप अपग्रेड करने से जुड़ी गाइड का इस्तेमाल करके, नए वर्शन पर अपग्रेड करें. |
| समय | हम औसतन हर तीन से चार महीने में एक नया वर्शन रिलीज़ करते हैं. इसलिए, दिया गया वर्शन करीब तीन से चार महीने बाद काम नहीं करेगा. | हमारा लक्ष्य है कि किसी वर्शन को रिलीज़ करने के एक साल बाद, उसे बंद कर दिया जाए. |
| एपीआई | बंद किए गए वर्शन के लिए एपीआई एंडपॉइंट अब भी पहले की तरह काम करते हैं.
हमारी क्लाइंट लाइब्रेरी, REST वगैरह का इस्तेमाल करके, हमारे एपीआई एंडपॉइंट ऐक्सेस किए जा सकते हैं. हालांकि, बंद किए गए वर्शन में नई सुविधाएं नहीं जोड़ी जाती हैं. |
बंद होने की तारीखों के बाद, बंद हो चुके वर्शन के लिए एपीआई एंडपॉइंट काम करना बंद कर देते हैं. अगर आपने बंद हो चुके वर्शन के एपीआई एंडपॉइंट को ऐक्सेस करने की कोशिश की, तो Google Ads API में गड़बड़ी का मैसेज दिखेगा. |
| क्लाइंट लाइब्रेरी | छोटी क्लाइंट लाइब्रेरी उपलब्ध कराने के लिए, हम एपीआई के बंद किए गए वर्शन को, क्लाइंट लाइब्रेरी के नए वर्शन में शामिल नहीं करेंगे. ऐसा, एपीआई के बंद होने की तारीख के बाद किया जाएगा. इससे, अपने प्रोजेक्ट में हमारी क्लाइंट लाइब्रेरी शामिल करते समय, आपको जगह बचाने में मदद मिलती है. | क्लाइंट लाइब्रेरी, एपीआई के बंद किए गए वर्शन के साथ काम नहीं करती हैं. ऐसा इसलिए, क्योंकि बंद किए जाने की तारीख के बाद, क्लाइंट लाइब्रेरी के किसी भी नए वर्शन में एपीआई के बंद किए गए वर्शन का इस्तेमाल नहीं किया जा सकता. |
| सहायता | हम बंद किए गए वर्शन के लिए नियमित तौर पर सहायता उपलब्ध कराते हैं. | किसी वर्शन को बंद किए जाने के बाद, वह वर्शन उपलब्ध नहीं होता. |
इस्तेमाल की जा सकने वाली क्लाइंट लाइब्रेरी के वर्शन
इस टेबल में बताया गया है कि कौनसी क्लाइंट लाइब्रेरी, एपीआई के किस वर्शन के साथ काम करती है.
Java
Google Ads API |
Java के लिए क्लाइंट लाइब्रेरी |
v23 |
Min: 42.0.0Max: - |
v22 |
Min: 41.1.0Max: - |
v21 |
Min: 39.0.0Max: - |
v20 |
Min: 38.0.0Max: - |
C#
Google Ads API |
.NET के लिए क्लाइंट लाइब्रेरी |
v23 |
Min: 25.0.0Max: - |
v22 |
Min: 24.1.0Max: - |
v21 |
Min: 24.0.0Max: - |
v20 |
Min: 23.0.0Max: - |
PHP
Google Ads API |
PHP के लिए क्लाइंट लाइब्रेरी |
v23 |
Min: 32.1.0Max: - |
v22 |
Min: 31.0.0Max: - |
v21 |
Min: 28.0.0Max: - |
v20 |
Min: 26.1.0Max: - |
Python
Google Ads API |
Python के लिए क्लाइंट लाइब्रेरी |
v23 |
Min: 29.0.0Max: - |
v22 |
Min: 28.1.0Max: - |
v21 |
Min: 28.0.0Max: - |
v20 |
Min: 27.0.0Max: - |
Ruby
Google Ads API |
Ruby के लिए क्लाइंट लाइब्रेरी |
v23 |
Min: 37.0.0Max: - |
v22 |
Min: 36.0.0Max: - |
v21 |
Min: 35.0.0Max: - |
v20 |
Min: 34.0.0Max: - |
Perl
Google Ads API |
Perl के लिए क्लाइंट लाइब्रेरी |
v23 |
Min: 30.0.0Max: - |
v22 |
Min: 29.0.0Max: - |
v21 |
Min: 28.0.0Max: - |
v20 |
Min: 27.0.0Max: - |
बंद की गई सुविधाएं
आने वाले समय में बंद होने वाली सुविधाओं के बारे में सबसे पहले जानने के लिए, Google Ads डेवलपर ब्लॉग को नियमित तौर पर देखें.
यहां दी गई टेबल में, Google Ads API के लिए बंद की जाने वाली सुविधाओं के बारे में बताया गया है. हर सुविधा के बंद होने के बारे में ज़्यादा जानकारी के लिए, लिंक की गई ब्लॉग पोस्ट पढ़ें.
| सुविधा | ब्यौरा | लागू होने की तारीख | अतिरिक्त जानकारी |
|---|---|---|---|
| आईपी पते और सेशन एट्रिब्यूट के साथ काम करने की सुविधा में बदलाव | Google Ads API, 2 फ़रवरी, 2026 से कन्वर्ज़न इंपोर्ट के हिस्से के तौर पर, सेशन एट्रिब्यूट या आईपी पते के डेटा का इस्तेमाल करने वाले नए लोगों के अनुरोध स्वीकार नहीं करेगा. मौजूदा उपयोगकर्ताओं को Data Manager API पर माइग्रेट करना होगा. | 2 फ़रवरी, 2026 | ज़्यादा जानकारी के लिए, हमारी ब्लॉग पोस्ट देखें. |
| सिर्फ़ कॉल दिलाने वाले विज्ञापनों को बंद किया जा रहा है | जनवरी 2026 से, सिर्फ़ कॉल दिलाने वाले नए विज्ञापन नहीं बनाए जा सकेंगे. सिर्फ़ कॉल दिलाने वाले मौजूदा विज्ञापन, फ़रवरी 2027 से दिखने बंद हो जाएंगे. साथ ही, एपीआई की सुविधा भी हटा दी जाएगी. विज्ञापन देने वाले लोगों या कंपनियों को इसके बजाय, कॉल ऐसेट के साथ रिस्पॉन्सिव सर्च विज्ञापनों का इस्तेमाल करना चाहिए. | जनवरी 2026 | ज़्यादा जानकारी के लिए, हमारी ब्लॉग पोस्ट देखें. |