रुकना और बंद होना

नया वर्शन रिलीज़ होने के बाद, उस वर्शन को बंद कर दिया जाता है जो अब सेवा में नहीं है. इसके बाद, वह वर्शन उपलब्ध नहीं होगा. यहां कुछ अन्य दिशा-निर्देश दिए गए हैं:

• एक बार में ज़्यादा से ज़्यादा तीन मुख्य वर्शन उपलब्ध होते हैं.
• मेजर वर्शन करीब 12 महीने तक चलते हैं—माइनर वर्शन: 10 महीने.
• आपको हर साल ज़्यादा से ज़्यादा दो अपग्रेड करने होंगे. साथ ही, आपको पूरी तरह से क्रम में अपग्रेड करने की ज़रूरत नहीं होगी. उदाहरण के लिए, आपके पास वर्शन (N) से सीधे वर्शन (N+2) पर अपग्रेड करने का विकल्प है.
• सभी क्लाइंट लाइब्रेरी को नए वर्शन के लिए रिलीज़ किए जाने और बंद होने वाले वर्शन के बीच का ओवरलैप, कम से कम 20 हफ़्ते का होता है.

हमारी क्लाइंट लाइब्रेरी किसी सेवा के सभी उपलब्ध वर्शन के साथ काम करती हैं. इसलिए, इस्तेमाल की गई सेवाओं के अलग-अलग वर्शन तय करके, उन्हें धीरे-धीरे अपग्रेड किया जा सकता है.

आने-जाने का समय

यहां दी गई टेबल में, उपलब्ध हर वर्शन के लिए, बंद होने और काम न करने की तारीखें दी गई हैं. साथ ही, आने वाले समय में रिलीज़ होने वाले वर्शन की अनुमानित तारीखें भी दी गई हैं. हमारा सुझाव है कि आप नए वर्शन के रिलीज़ होते ही, उसे जल्द से जल्द अपग्रेड कर लें.

API वर्शन	रिलीज़ की तारीख	रोक लगाने की तारीख	सूरज ढलने की तारीख	अपग्रेड करने के लिए गाइड
v18	16 अक्टूबर, 2024	फ़रवरी 2025	24 सितंबर, 2025
v17.1	7 अगस्त, 2024	सितंबर/अक्टूबर 2024	4 जून, 2025	v17 से v18 पर अपग्रेड करना
v17	5 जून, 2024	सितंबर/अक्टूबर 2024	4 जून, 2025	v17 से v18 पर अपग्रेड करना
v16.1	24 अप्रैल, 2024	5 जून, 2024	5 फ़रवरी, 2025	v16 से v17 पर अपग्रेड करना
v16	21 फ़रवरी, 2024	5 जून, 2024	5 फ़रवरी, 2025	v16 से v17 पर अपग्रेड करना

उन वर्शन को देखें जिनका इस्तेमाल आपका प्रोजेक्ट कर रहा है

Google Cloud Console का इस्तेमाल करके, उन तरीकों और सेवाओं की सूची देखी जा सकती है जिन्हें आपने हाल ही में प्रोजेक्ट से कॉल किया है:

1. Google Cloud Console में एपीआई और सेवाएं खोलें.
2. टेबल में, Google Ads API पर क्लिक करें.
3. मेट्रिक सब-टैब में, आपको हर ग्राफ़ पर अपने हाल ही के अनुरोध दिखेंगे. तरीके टेबल में, यह देखा जा सकता है कि आपने किन तरीकों पर अनुरोध भेजे हैं. तरीके के नाम में, Google Ads API का वर्शन, सेवा, और तरीके का नाम शामिल होता है, जैसे कि google.ads.googleads.v18.services.GoogleAdsService.Mutate.
4. (ज़रूरी नहीं) वह समयावधि चुनें जिसमें आपको अपने अनुरोधों की जानकारी देखनी है.

बंद हो चुकी सुविधा और सेवा बंद होने के बीच अंतर

शब्द	बंद होना	सनसेट
परिभाषा	बंद किया गया वर्शन, नया वर्शन नहीं होता. नया वर्शन रिलीज़ होने के बाद, पिछले सभी वर्शन अब सेवा में नहीं हैं के तौर पर मार्क कर दिए जाएंगे.	बंद हो चुके वर्शन का अब इस्तेमाल नहीं किया जा सकता. इस वर्शन पर भेजे गए अनुरोध, बंद होने की तारीख को या उसके बाद काम नहीं करेंगे.
मतलब	अब भी इस्तेमाल नहीं किए जा रहे वर्शन का इस्तेमाल तब तक किया जा सकता है, जब तक कि वे सूरज नहीं हो जाते. हालांकि, काम नहीं करने वाले वर्शन के रेफ़रंस से यह पता चलता है कि वे अब नए वर्शन नहीं हैं. हमारा सुझाव है कि आप जल्द से जल्द नए वर्शन में अपग्रेड करें, ताकि नई सुविधाओं का फ़ायदा मिल सके.	Google Ads API का इस्तेमाल करने के लिए, आपको बंद हो चुके वर्शन से तुरंत अपग्रेड करना होगा. हमारा सुझाव है कि आप अपग्रेड करने की गाइड का इस्तेमाल करके, नए वर्शन पर अपग्रेड करें.
समय	हम औसतन हर तीन से चार महीने में नया वर्शन रिलीज़ करते हैं. इसलिए, दिया गया वर्शन करीब तीन से चार महीने बाद बंद कर दिया जाएगा.	हम वर्शन को रिलीज़ होने के एक साल बाद बंद करने वाले हैं.
एपीआई	अब काम नहीं करने वाले वर्शन के लिए, एपीआई एंडपॉइंट अब भी सामान्य तरीके से काम करते रहेंगे. हमारी क्लाइंट लाइब्रेरी, REST वगैरह का इस्तेमाल करके, हमारे एपीआई एंडपॉइंट को ऐक्सेस किया जा सकता है. हालांकि, काम न करने वाले वर्शन में नई सुविधाएं नहीं जोड़ी जाती हैं.	बंद किए जाने की तारीखों के बाद, बंद किए गए वर्शन के लिए एपीआई एंडपॉइंट काम करना बंद कर देते हैं. अगर बंद किए गए वर्शन के एपीआई एंडपॉइंट को ऐक्सेस करने की कोशिश की जाती है, तो Google Ads API गड़बड़ी का मैसेज दिखाएगा.
क्लाइंट लाइब्रेरी	कॉम्पैक्ट क्लाइंट लाइब्रेरी उपलब्ध कराने के लिए, हम एपीआई के बंद किए गए वर्शन को नई क्लाइंट लाइब्रेरी के वर्शन में शामिल करना बंद कर देंगे. इससे, अपने प्रोजेक्ट में हमारी क्लाइंट लाइब्रेरी को शामिल करते समय, जगह बचाने में मदद मिलती है. अहम जानकारी: अब काम न करने वाले एपीआई वर्शन, पहले रिलीज़ की गई क्लाइंट लाइब्रेरी के वर्शन में अब भी उपलब्ध हैं. एपीआई के वर्शन बंद होने तक, उन्हें डाउनलोड और इस्तेमाल किया जा सकता है.	बंद किए जाने की तारीखों के बाद, क्लाइंट लाइब्रेरी के किसी भी नए वर्शन में, बंद किए गए एपीआई वर्शन काम नहीं करते.
सहायता	हम बंद किए गए वर्शन के लिए नियमित तौर पर सहायता उपलब्ध कराते हैं.	इस तारीख के बाद, इस वर्शन को इस्तेमाल नहीं किया जा सकेगा.

क्लाइंट लाइब्रेरी के इस्तेमाल किए जा सकने वाले वर्शन

इस टेबल से पता चलता है कि कौनसी क्लाइंट लाइब्रेरी, एपीआई के किन वर्शन के साथ काम करती हैं.

Java

Google Ads API	Java के लिए क्लाइंट लाइब्रेरी
v18	Min: 34.0.0 Max: -
v17	Min: 32.0.0 Max: -
v16	Min: 30.0.0 Max: -

C#

Google Ads API	.NET के लिए क्लाइंट लाइब्रेरी
v18	Min: 21.1.0 Max: -
v17	Min: 20.1.0 Max: -
v16	Min: 18.1.0 Max: -

PHP

Google Ads API	PHP के लिए क्लाइंट लाइब्रेरी
v18	Min: 25.0.0 Max: -
v17	Min: 23.1.0 Max: -
v16	Min: 22.1.0 Max: -

Python

Google Ads API	Python के लिए क्लाइंट लाइब्रेरी
v18	Min: 25.1.0 Max: -
v17	Min: 24.1.0 Max: -
v16	Min: 23.1.0 Max: -

Ruby

Google Ads API	Ruby के लिए क्लाइंट लाइब्रेरी
v18	Min: 31.0.0 Max: -
v17	Min: 29.0.0 Max: -
v16	Min: 27.0.0 Max: -

Perl

Google Ads API	Perl के लिए क्लाइंट लाइब्रेरी
v18	Min: 25.0.0 Max: -
v17	Min: 23.0.0 Max: -
v16	Min: 21.0.0 Max: -

बंद की गई सुविधाएं

आने वाले समय में किसी सुविधा के बंद होने के बारे में सबसे पहले जानने के लिए, Google Ads डेवलपर ब्लॉग को नियमित तौर पर देखते रहें.

इस टेबल में, उन सुविधाओं की सूची दी गई है जिन्हें Google Ads API के लिए फ़िलहाल बंद करने का प्लान है. हर एक सुविधा बंद होने के बारे में ज़्यादा जानकारी लिंक की गई ब्लॉग पोस्ट में मिल सकती है.

सुविधा	ब्यौरा	लागू होने की तारीख	और जानकारी
Google Ads API में पेज साइज़ में होने वाले बदलाव	वर्शन 16 बंद होने के बाद, GoogleAdsService.Search के अनुरोध करते समय, page_size फ़ील्ड को सेट नहीं किया जा सकेगा.	जनवरी 2025	v16 के बंद होने के बाद, सभी GoogleAdsService.Search अनुरोधों के लिए यह माना जाएगा कि पेज का साइज़ 10,000 पंक्तियों का है.
बेहतर CPC बोली-प्रक्रिया कार्यनीति	Google Ads API अब सर्च और डिसप्ले कैंपेन के लिए, बिडिंग की रणनीति के तौर पर ईसीपीसी सेट करने की सुविधा उपलब्ध नहीं है.	अक्टूबर 2024	बिडिंग की रणनीति में, enhanced_cpc_enabled फ़ील्ड को TRUE पर सेट करने के अनुरोधों की वजह से, BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED गड़बड़ी का मैसेज दिखेगा. ईसीपीसी बिडिंग की रणनीति का इस्तेमाल करने वाले मौजूदा कैंपेन, 15 मार्च, 2025 तक चलते रहेंगे. इस तारीख के बाद, वे हर क्लिक की लागत (सीपीसी) के लिए मैन्युअल बिडिंग पर अपने-आप माइग्रेट हो जाएंगे.