किसी नए वर्शन के रिलीज़ होने पर, बंद किए जाने वाले वर्शन के लिए, बंद किए जाने की तारीख तय की जाती है. इसके बाद, वह वर्शन उपलब्ध नहीं होता. यहां कुछ अन्य दिशा-निर्देश दिए गए हैं, जिन्हें ध्यान में रखना ज़रूरी है:
- हम कोशिश करते हैं कि किसी भी समय ज़्यादा से ज़्यादा पांच मेजर वर्शन उपलब्ध हों.
- मेजर वर्शन की लाइफ़स्पैन करीब 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.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: - |
C#
Google Ads API |
.NET के लिए क्लाइंट लाइब्रेरी |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
PHP
Google Ads API |
PHP के लिए क्लाइंट लाइब्रेरी |
v25 |
Min: 33.6.0Max: - |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
Python
Google Ads API |
Python के लिए क्लाइंट लाइब्रेरी |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
Ruby
Google Ads API |
Ruby के लिए क्लाइंट लाइब्रेरी |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
Perl
Google Ads API |
Perl के लिए क्लाइंट लाइब्रेरी |
v25 |
Min: 33.0.0Max: - |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
सुविधाओं को बंद करना और उनमें बदलाव करना
इस पेज पर, एपीआई वर्शन-लेवल के लाइफ़साइकल पर फ़ोकस किया गया है. हालांकि, अलग-अलग सुविधाओं के बंद होने (जैसे, स्मार्ट कैंपेन के बंद होने) और वर्शन के बिना वर्कफ़्लो में हुए बदलावों (जैसे, मांग बढ़ाने में मदद करने वाले नए कैंपेन के बजट से जुड़ी ज़रूरी शर्तें) को अलग से ट्रैक किया जाता है.
चालू वर्शन में, आने वाले समय में सुविधा के लाइफ़साइकल और व्यवहार में होने वाले बदलावों के बारे में जानने के लिए, सुविधा बंद होने और वर्शन से जुड़े बदलावों की गाइड देखें.