नए वर्शन के रिलीज़ होने के बाद, बंद किए गए वर्शन के लिए बंद होने की तारीख तय की जाती है. इस तारीख के बाद, वह वर्शन उपलब्ध नहीं होता. यहां कुछ अन्य दिशा-निर्देश दिए गए हैं, जिनका आपको पालन करना होगा:
- हमारा मकसद है कि किसी भी समय, ज़्यादा से ज़्यादा चार मेजर वर्शन उपलब्ध रहें.
- मेजर वर्शन की लाइफ़स्पैन करीब 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 के लिए बंद की जाने वाली सुविधाओं के बारे में बताया गया है. हर बदलाव के बारे में ज़्यादा जानकारी, लिंक की गई ब्लॉग पोस्ट में देखी जा सकती है.
| सुविधा | ब्यौरा | लागू होने की तारीख | अतिरिक्त जानकारी |
|---|---|---|---|
| ऐप्लिकेशन कैंपेन की परफ़ॉर्मेंस पर असर डालने वाला कन्वर्ज़न एनवायरमेंट | हम 30 सितंबर, 2025 से, बिडिंग मॉडल में धीरे-धीरे बदलाव करना शुरू करेंगे. इससे वे इंपोर्ट किए गए कन्वर्ज़न में शामिल कन्वर्ज़न एनवायरमेंट डेटा का इस्तेमाल करके, कैंपेन की परफ़ॉर्मेंस को ऑप्टिमाइज़ कर पाएंगे. | 3 अक्टूबर, 2025 | ज़्यादा जानकारी के लिए, हमारी ब्लॉग पोस्ट देखें. |
| कन्वर्ज़न में `gclid` और `gbraid`, दोनों वैल्यू शामिल हो सकती हैं. | अगर `gclid` और `gbraid`, दोनों फ़ील्ड सेट किए गए हैं, तो इंपोर्ट किए गए कन्वर्ज़न में 3 अक्टूबर, 2025 से `VALUE_MUST_BE_UNSET` गड़बड़ी नहीं दिखेगी. | 3 अक्टूबर, 2025 | ज़्यादा जानकारी के लिए, हमारी ब्लॉग पोस्ट देखें. |