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