जब कोई नया वर्शन रिलीज़ किया जाता है, तो बंद किए गए वर्शन के लिए, बंद होने की तारीख तय कर दी जाती है. इस तारीख के बाद, वह वर्शन उपलब्ध नहीं होता. यहां कुछ अन्य दिशा-निर्देश दिए गए हैं, जिन्हें ध्यान में रखना ज़रूरी है:
- हम कोशिश करते हैं कि किसी भी समय ज़्यादा से ज़्यादा पांच मेजर वर्शन उपलब्ध हों.
- मेजर वर्शन की लाइफ़साइकल करीब 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 | 19 अगस्त, 2026 | अगस्त 2027 | v25 से v25.1 पर अपग्रेड करना |
| v25.2 | 23 सितंबर, 2026 | अगस्त 2027 | v25.1 से v25.2 पर अपग्रेड करना |
| आने वाले वर्शन | |||
| v26 | अक्टूबर 2026 | नवंबर 2027 | |
| v26.1 | अक्टूबर 2026 | नवंबर 2027 | |
| v26.2 | नवंबर 2026 | नवंबर 2027 | |
| v26.3* | दिसंबर 2026 | नवंबर 2027 | |
| v27 | जनवरी 2027 | फ़रवरी 2028 | |
| v27.1 | फ़रवरी 2027 | फ़रवरी 2028 | |
| v27.2 | फ़रवरी 2027 | फ़रवरी 2028 | |
| v27.3 | मार्च 2027 | फ़रवरी 2028 | |
| v27.4 | मार्च 2027 | फ़रवरी 2028 | |
| v28 | अप्रैल 2027 | मई 2028 | |
| v28.1 | अप्रैल 2027 | मई 2028 | |
| v28.2 | मई 2027 | मई 2028 | |
| v28.3 | मई 2027 | मई 2028 | |
| v28.4 | जून 2027 | मई 2028 | |
| v28.5 | जून 2027 | मई 2028 | |
| v29 | जुलाई 2027 | अगस्त 2028 | |
| v29.1 | जुलाई 2027 | अगस्त 2028 | |
| v29.2 | अगस्त 2027 | अगस्त 2028 | |
| v29.3 | अगस्त 2027 | अगस्त 2028 | |
| v29.4 | सितंबर 2027 | अगस्त 2028 | |
| v29.5 | सितंबर 2027 | अगस्त 2028 | |
| v30 | अक्टूबर 2027 | नवंबर 2028 | |
| v30.1 | अक्टूबर 2027 | नवंबर 2028 | |
| v30.2 | नवंबर 2027 | नवंबर 2028 | |
| v30.3* | दिसंबर 2027 | नवंबर 2028 | |
* v26.3 और v30.3 को वैकल्पिक रिलीज़ के तौर पर तय किया गया है, क्योंकि ये छुट्टियों के सीज़न के साथ ओवरलैप होती हैं.
अपने प्रोजेक्ट में इस्तेमाल किए जा रहे वर्शन देखना
Google Cloud Console का इस्तेमाल करके, उन तरीकों और सेवाओं की सूची देखी जा सकती है जिन्हें आपके प्रोजेक्ट ने हाल ही में कॉल किया है:
- Google Cloud Console में एपीआई और सेवाएं खोलें.
- टेबल में Google Ads API पर क्लिक करें.
- मेट्रिक सब-टैब में, आपको हर ग्राफ़ पर अपने हाल ही के अनुरोध दिखेंगे. तरीके टेबल में जाकर, यह देखा जा सकता है कि आपने किन तरीकों के लिए अनुरोध भेजे हैं. तरीके के नाम में Google Ads API का वर्शन, सेवा, और तरीके का नाम शामिल होता है. जैसे,
google.ads.googleads.v26.services.GoogleAdsService.Mutate. - (ज़रूरी नहीं) वह समयावधि चुनें जिसके लिए आपको अनुरोध देखने हैं.
बंद होने और बंद किए जाने के बीच अंतर
| शब्द | बंद की गई सेवाएं/सुविधाएं | सूर्यास्त |
|---|---|---|
| परिभाषा | इस्तेमाल से बाहर किया गया वर्शन, नया वर्शन नहीं होता. नया वर्शन रिलीज़ होने के बाद, सभी पिछले वर्शन को बंद किया गया के तौर पर मार्क कर दिया जाएगा. | बंद किए गए वर्शन का इस्तेमाल नहीं किया जा सकता. इस वर्शन के बंद होने की तारीख या उसके बाद, इस वर्शन पर भेजे गए अनुरोध पूरे नहीं होंगे. |
| नतीजा | बहिष्कृत किए गए वर्शन का इस्तेमाल तब तक किया जा सकता है, जब तक उन्हें बंद नहीं कर दिया जाता. हालांकि, बहिष्कृत किए गए वर्शन के रेफ़रंस को डी-हाइलाइट कर दिया जाता है, ताकि यह पता चल सके कि वे अब नया वर्शन नहीं हैं.
हमारा सुझाव है कि आप जल्द से जल्द नए वर्शन पर अपग्रेड करें, ताकि आपको नई सुविधाओं का फ़ायदा मिल सके. |
Google Ads API का इस्तेमाल करने के लिए, आपको बंद हो चुके वर्शन से तुरंत अपग्रेड करना होगा.
हमारा सुझाव है कि आप अपग्रेड गाइड का इस्तेमाल करके, नए वर्शन पर अपग्रेड करें. |
| समय | हम आम तौर पर, हर तीन से चार महीने में एक नया वर्शन रिलीज़ करते हैं. इसलिए, दिया गया वर्शन करीब तीन से चार महीने बाद काम नहीं करेगा. | हमारा लक्ष्य है कि किसी वर्शन को रिलीज़ होने के एक साल बाद बंद कर दिया जाए. |
| एपीआई | बंद किए गए वर्शन के एपीआई एंडपॉइंट अब भी पहले की तरह काम करते हैं.
हमारी क्लाइंट लाइब्रेरी और REST का इस्तेमाल करके, हमारे एपीआई एंडपॉइंट ऐक्सेस किए जा सकते हैं. हालांकि, बंद किए जा चुके वर्शन में नई सुविधाएं नहीं जोड़ी जाती हैं. |
बंद किए जाने की तारीख के बाद, बंद किए गए वर्शन के लिए एपीआई एंडपॉइंट काम करना बंद कर देते हैं. अगर आपने बंद हो चुके वर्शन के एपीआई एंडपॉइंट को ऐक्सेस करने की कोशिश की, तो Google Ads API गड़बड़ी का मैसेज दिखाएगा. |
| क्लाइंट लाइब्रेरी | क्लाइंट लाइब्रेरी को छोटा बनाने के लिए, हम बंद किए गए एपीआई वर्शन को, क्लाइंट लाइब्रेरी के नए वर्शन में शामिल नहीं करेंगे. ऐसा, बंद किए जाने की तारीख के बाद किया जाएगा. इससे आपको अपने प्रोजेक्ट में हमारी क्लाइंट लाइब्रेरी शामिल करते समय, स्टोरेज बचाने में मदद मिलती है. | बंद किए जाने की तारीख के बाद, क्लाइंट लाइब्रेरी के किसी भी नए वर्शन में, एपीआई के बंद किए गए वर्शन काम नहीं करते. |
| सहायता | हम बंद किए जा चुके वर्शन के लिए, नियमित तौर पर सहायता उपलब्ध कराते हैं. | किसी वर्शन को बंद किए जाने के बाद, वह वर्शन उपलब्ध नहीं होता. |
क्लाइंट लाइब्रेरी के इस्तेमाल किए जा सकने वाले वर्शन
इस टेबल में बताया गया है कि कौनसी क्लाइंट लाइब्रेरी, एपीआई के किस वर्शन के साथ काम करती है.
Google Ads API के मुख्य वर्शन (जैसे, v26) के लिए, क्लाइंट लाइब्रेरी का दिया गया सबसे नया वर्शन काफ़ी है. माइनर रिलीज़ के लिए ज़रूरी क्लाइंट लाइब्रेरी वर्शन देखने के लिए, लिंक किया गया बदलावों का लॉग देखें.
Java
Google Ads API |
Java के लिए क्लाइंट लाइब्रेरी |
v26 |
Min: 48.0.0Max: - |
v25 |
Min: 44.0.0Max: - |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
C#
Google Ads API |
.NET के लिए क्लाइंट लाइब्रेरी |
v26 |
Min: 27.5.0Max: - |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
PHP
Google Ads API |
PHP के लिए क्लाइंट लाइब्रेरी |
v26 |
Min: 35.2.0Max: - |
v25 |
Min: 33.6.0Max: - |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
Python
Google Ads API |
Python के लिए क्लाइंट लाइब्रेरी |
v26 |
Min: 34.0.0Max: - |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
Ruby
Google Ads API |
Ruby के लिए क्लाइंट लाइब्रेरी |
v26 |
Min: 46.0.0Max: - |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
Perl
Google Ads API |
Perl के लिए क्लाइंट लाइब्रेरी |
v26 |
Min: 36.0.0Max: - |
v25 |
Min: 33.0.0Max: - |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
सुविधाओं को बंद करना और उनमें बदलाव करना
इस पेज पर, एपीआई वर्शन-लेवल के लाइफ़साइकल पर फ़ोकस किया गया है. हालांकि, अलग-अलग सुविधाओं के बंद होने (जैसे, स्मार्ट कैंपेन के बंद होने) और वर्शन के बिना वर्कफ़्लो में हुए बदलावों (जैसे, मांग बढ़ाने में मदद करने वाले नए कैंपेन के बजट से जुड़ी ज़रूरी शर्तें) को अलग से ट्रैक किया जाता है.
चालू वर्शन में, आने वाले समय में सुविधा के लाइफ़साइकल और व्यवहार में होने वाले बदलावों के बारे में जानने के लिए, सुविधा बंद होने और वर्शन से जुड़े बदलावों की गाइड देखें.