जब कोई नया वर्शन रिलीज़ किया जाता है, तो बंद किए गए वर्शन के लिए बंद होने की तारीख तय की जाती है. इस तारीख के बाद, वह वर्शन उपलब्ध नहीं होता. यहां कुछ अन्य दिशा-निर्देश दिए गए हैं, जिनका आपको पालन करना होगा:
- हमारा लक्ष्य है कि एक समय में ज़्यादा से ज़्यादा पांच मेजर वर्शन उपलब्ध हों.
- मेजर वर्शन की लाइफ़स्पैन करीब 12 महीने होती है. वहीं, माइनर वर्शन की लाइफ़स्पैन 10 महीने होती है.
- आपको हर साल ज़्यादा से ज़्यादा दो बार अपग्रेड करना होगा. साथ ही, आपको क्रम से अपग्रेड करने की ज़रूरत नहीं है. उदाहरण के लिए, वर्शन (N) से सीधे वर्शन (N+2) पर अपग्रेड किया जा सकता है.
हमारी क्लाइंट लाइब्रेरी, किसी सेवा के सभी उपलब्ध वर्शन के साथ काम करती हैं. इसलिए, इस्तेमाल की गई सेवाओं के अलग-अलग वर्शन तय करके, धीरे-धीरे अपग्रेड किया जा सकता है.
आने-जाने का समय
यहां दी गई टेबल में, हर उपलब्ध वर्शन के लिए बंद होने की तारीखों के बारे में बताया गया है. साथ ही, आने वाले समय में रिलीज़ होने वाले वर्शन की अनुमानित तारीखों के बारे में भी बताया गया है. हमारा सुझाव है कि आप नया वर्शन रिलीज़ होने के बाद, जल्द से जल्द उसे अपग्रेड करें. अनुमानित तारीख का मतलब है कि उस महीने में किसी भी समय बंद किया जा सकता है. साथ ही, तारीखों में बदलाव भी हो सकता है. एपीआई वर्शन के बंद होने की सूचना से जुड़े रिमाइंडर पाने के लिए, ब्लॉग की सदस्यता लें.
| API वर्शन | रिलीज़ की तारीख | माइग्रेशन पूरा करने की समयसीमा | अपग्रेड करने के लिए गाइड |
|---|---|---|---|
| रिलीज़ किए गए वर्शन | |||
| v22 | 15 अक्टूबर, 2025 | अक्टूबर 2026 (अनुमानित) | v21 से v22 में अपग्रेड करना |
| v23 | 28 जनवरी, 2026 | फ़रवरी 2027 | v22 से 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 | अगस्त 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.v25.services.GoogleAdsService.Mutate. - (ज़रूरी नहीं) वह समयावधि चुनें जिसके लिए आपको अनुरोध देखने हैं.
डिप्रेकेट और बंद होने में अंतर
| शब्द | बंद की गई सेवाएं/सुविधाएं | सूर्यास्त |
|---|---|---|
| परिभाषा | पुराना वर्शन, नया वर्शन नहीं होता. नया वर्शन रिलीज़ होने के बाद, सभी पिछले वर्शन को बंद कर दिया जाएगा. | बंद किए गए वर्शन का इस्तेमाल नहीं किया जा सकता. इस वर्शन पर भेजे गए अनुरोध, बंद होने की तारीख को या उसके बाद पूरे नहीं किए जा सकेंगे. |
| नतीजा | बंद किए गए वर्शन का इस्तेमाल तब तक किया जा सकता है, जब तक उन्हें बंद नहीं कर दिया जाता. हालांकि, बंद किए गए वर्शन के रेफ़रंस को डी-हाइलाइट कर दिया जाता है, ताकि यह पता चल सके कि वे अब नए वर्शन नहीं हैं.
हमारा सुझाव है कि नई सुविधाओं का फ़ायदा पाने के लिए, जल्द से जल्द नए वर्शन पर अपग्रेड करें. |
Google Ads API का इस्तेमाल करने के लिए, आपको बंद हो चुके वर्शन से तुरंत अपग्रेड करना होगा.
हमारा सुझाव है कि आप अपग्रेड करने से जुड़ी गाइड का इस्तेमाल करके, नए वर्शन पर अपग्रेड करें. |
| समय | हम औसतन हर तीन से चार महीने में नया वर्शन रिलीज़ करते हैं. इसलिए, दिया गया वर्शन करीब तीन से चार महीने बाद काम नहीं करेगा. | हमारा लक्ष्य है कि किसी वर्शन को रिलीज़ करने के एक साल बाद, उसे बंद कर दिया जाए. |
| एपीआई | बंद किए गए वर्शन के एपीआई एंडपॉइंट अब भी पहले की तरह काम करते हैं.
हमारी क्लाइंट लाइब्रेरी और REST का इस्तेमाल करके, हमारे एपीआई एंडपॉइंट ऐक्सेस किए जा सकते हैं. हालांकि, बंद किए गए वर्शन में नई सुविधाएं नहीं जोड़ी जाती हैं. |
सनसेट की तारीखों के बाद, सनसेट किए गए वर्शन के लिए एपीआई एंडपॉइंट काम करना बंद कर देते हैं. अगर बंद हो चुके वर्शन के एपीआई एंडपॉइंट को ऐक्सेस करने की कोशिश की जाती है, तो Google Ads API गड़बड़ी का मैसेज दिखाएगा. |
| क्लाइंट लाइब्रेरी | छोटी क्लाइंट लाइब्रेरी उपलब्ध कराने के लिए, हम एपीआई के बंद किए गए वर्शन को, क्लाइंट लाइब्रेरी के नए वर्शन में शामिल नहीं करेंगे. ऐसा, एपीआई के बंद होने की तारीख के बाद किया जाएगा. इससे, अपने प्रोजेक्ट में हमारी क्लाइंट लाइब्रेरी शामिल करते समय जगह बचाने में मदद मिलती है. | क्लाइंट लाइब्रेरी, बंद किए गए एपीआई वर्शन के साथ काम नहीं करती. ऐसा इसलिए, क्योंकि बंद किए गए एपीआई वर्शन के बाद, क्लाइंट लाइब्रेरी के किसी भी नए वर्शन में ये एपीआई वर्शन काम नहीं करते. |
| सहायता | हम बंद किए गए वर्शन के लिए नियमित तौर पर सहायता उपलब्ध कराते हैं. | किसी वर्शन को बंद किए जाने के बाद, वह वर्शन उपलब्ध नहीं होता. |
इस्तेमाल की जा सकने वाली क्लाइंट लाइब्रेरी के वर्शन
इस टेबल में बताया गया है कि कौनसी क्लाइंट लाइब्रेरी, एपीआई के किस वर्शन के साथ काम करती है.
Google Ads API के मुख्य वर्शन (जैसे, v25) के लिए, क्लाइंट लाइब्रेरी का दिया गया सबसे नया वर्शन काफ़ी है. माइनर रिलीज़ के लिए, क्लाइंट लाइब्रेरी का ज़रूरी वर्शन देखने के लिए, लिंक किए गए बदलाव के लॉग पर जाएं.
Java
Google Ads API |
Java के लिए क्लाइंट लाइब्रेरी |
v25 |
Min: 44.0.0Max: - |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
v22 |
Min: 41.0.0Max: - |
C#
Google Ads API |
.NET के लिए क्लाइंट लाइब्रेरी |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
v22 |
Min: 24.1.0Max: - |
PHP
Google Ads API |
PHP के लिए क्लाइंट लाइब्रेरी |
v25 |
Min: 33.6.0Max: - |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
v22 |
Min: 31.0.0Max: - |
Python
Google Ads API |
Python के लिए क्लाइंट लाइब्रेरी |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
v22 |
Min: 28.1.0Max: - |
Ruby
Google Ads API |
Ruby के लिए क्लाइंट लाइब्रेरी |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
v22 |
Min: 36.0.0Max: - |
Perl
Google Ads API |
Perl के लिए क्लाइंट लाइब्रेरी |
v25 |
Min: 33.0.0Max: - |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
v22 |
Min: 29.0.0Max: - |
सुविधाओं को बंद करना और उनमें बदलाव करना
यह पेज, एपीआई के वर्शन-लेवल के लाइफ़साइकल पर फ़ोकस करता है. हालांकि, अलग-अलग सुविधाओं के बंद होने (जैसे, स्मार्ट कैंपेन का बंद होना) और वर्शन के बिना वर्कफ़्लो में होने वाले बदलावों (जैसे, मांग बढ़ाने में मदद करने वाले नए कैंपेन के बजट की ज़रूरी शर्तें) को अलग से ट्रैक किया जाता है.
चालू वर्शन में, आने वाले समय में सुविधा के लाइफ़साइकल और व्यवहार में होने वाले बदलावों के बारे में जानने के लिए, सुविधा बंद होने और वर्शन से जुड़े बदलावों के बारे में जानकारी देने वाली गाइड देखें.