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

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

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

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

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

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

API वर्शन रिलीज़ की तारीख बंद करने की तारीख सूरज ढलने की तारीख अपग्रेड गाइड
v18 सितंबर/अक्टूबर 2024 जनवरी/फ़रवरी 2025 सितंबर 2025
v17.1 जुलाई/अगस्त 2024 सितंबर/अक्टूबर 2024 मई 2025
v17 मई/जून 2024 सितंबर/अक्टूबर 2024 मई 2025
v16.1 24 अप्रैल, 2024 मई/जून 2024 जनवरी 2025
v16 21 फ़रवरी, 2024 मई/जून 2024 जनवरी 2025
v15 18 अक्टूबर, 2023 21 फ़रवरी, 2024 25 सितंबर, 2024 v15 से v16 पर अपग्रेड करना
v14.1 9 अगस्त, 2023 18 अक्टूबर, 2023 5 जून, 2024
v14 7 जून, 2023 18 अक्टूबर, 2023 5 जून, 2024 v14 से v15 पर अपग्रेड करना

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

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

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

बंद करने और खत्म होने के बीच अंतर

टर्मबंद किया गयासनसेट
परिभाषा जिस वर्शन के लिए सेवा बंद कर दी गई है वह नया वर्शन नहीं है. नया वर्शन रिलीज़ होने के बाद, सभी पिछले वर्शन को अब सेवा में नहीं है के तौर पर मार्क कर दिया जाएगा. इस वर्शन का अब इस्तेमाल नहीं किया जा सकता. बंद होने की तारीख को या उसके बाद, इस वर्शन को भेजे गए अनुरोध प्रोसेस नहीं किए जा सकेंगे.
अहम जानकारी बंद किए गए वर्शन को तब तक इस्तेमाल किया जा सकता है, जब तक वे सूर्यास्त नहीं हो जाते. हालांकि, काम न करने वाले वर्शन की पहचान फ़ाइलों को हाइलाइट करके, यह दिखाने के लिए हटा दिया जाता है कि वे सबसे नए वर्शन नहीं हैं.

हमारा सुझाव है कि नई सुविधाओं का फ़ायदा पाने के लिए, आप जल्द से जल्द नए वर्शन पर अपग्रेड करें.

Google Ads API का इस्तेमाल करने के लिए, आपको बंद हो चुके वर्शन से तुरंत अपग्रेड करना होगा.

हमारा सुझाव है कि आप अपग्रेड गाइड का इस्तेमाल करके, नए वर्शन पर अपग्रेड करें.

समय आम तौर पर, हम हर तीन से चार महीनों में नया वर्शन रिलीज़ करते हैं. इसलिए, दिया गया वर्शन करीब तीन से चार महीनों बाद काम करना बंद कर देगा. हमारा लक्ष्य किसी वर्शन को रिलीज़ किए जाने के एक साल बाद उसे बंद करना है.
API जो वर्शन काम नहीं करते उनके लिए एपीआई एंडपॉइंट अब भी हमेशा की तरह काम करते रहेंगे.

हमारी क्लाइंट लाइब्रेरी, REST वगैरह का इस्तेमाल करके, हमारे एपीआई एंडपॉइंट ऐक्सेस किए जा सकते हैं. हालांकि, काम न करने वाले वर्शन में नई सुविधाएं नहीं जोड़ी गई हैं.

बंद होने वाले वर्शन के लिए, एपीआई एंडपॉइंट बंद होने की तारीखों के बाद काम करना बंद करते हैं. अगर बंद किए गए वर्शन के एपीआई एंडपॉइंट को ऐक्सेस करने की कोशिश की जाती है, तो Google Ads API गड़बड़ी की जानकारी देगा.
क्लाइंट लाइब्रेरी कॉम्पैक्ट क्लाइंट लाइब्रेरी उपलब्ध कराने के लिए, हम क्लाइंट लाइब्रेरी के नए वर्शन में, एपीआई के उन वर्शन को शामिल करना बंद कर देंगे जो अब सेवा में नहीं हैं. ये वर्शन, क्लाइंट लाइब्रेरी के नए वर्शन में, एपीआई बंद होने की तारीख के बाद शामिल किए जाएंगे. इससे आपको अपने प्रोजेक्ट में हमारी क्लाइंट लाइब्रेरी शामिल करते समय जगह बचाने में मदद मिलती है. क्लाइंट लाइब्रेरी, सेवा बंद होने की तारीखों के बाद, क्लाइंट लाइब्रेरी के किसी भी नए वर्शन में, एपीआई के बंद होने वाले वर्शन पर काम नहीं करती.
सहायता हम बंद किए गए वर्शन के लिए नियमित सहायता देते हैं. बंद होने की तारीख के बाद, 'बंद वर्शन' इस्तेमाल नहीं किया जा सकता.

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

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

Java

Java के लिए क्लाइंट लाइब्रेरी
v16 Min: 30.0.0
Max: -
v15 Min: 28.0.0
Max: -
v14 Min: 26.0.0
Max: 30.0.0

C#

.NET के लिए क्लाइंट लाइब्रेरी
v16 Min: 18.1.0
Max: -
v15 Min: 17.1.0
Max: -
v14 Min: 16.1.0
Max: 19.0.1

PHP

PHP के लिए क्लाइंट लाइब्रेरी
v16 Min: 22.1.0
Max: -
v15 Min: 21.1.0
Max: -

Python

Python के लिए क्लाइंट लाइब्रेरी
v16 Min: 23.1.0
Max: -
v15 Min: 22.1.0
Max: -

Ruby

Ruby के लिए क्लाइंट लाइब्रेरी
v16 Min: 27.0.0
Max: -
v15 Min: 25.0.0
Max: -
v14 Min: 23.0.0
Max: -

Perl

Perl के लिए क्लाइंट लाइब्रेरी
v16 Min: 21.0.0
Max: -
v15 Min: 19.0.0
Max: -
v14 Min: 17.0.0
Max: 21.0.0

सुविधा बंद होना

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

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

सुविधा ब्यौरा लागू होने की तारीख और जानकारी
कमीशन के लिए बोली लगाने की रणनीति Google Ads API अब COMMISSION बिडिंग की रणनीति का इस्तेमाल करके, होटल कैंपेन नहीं बना सकता. 30 अप्रैल, 2024 नए होटल कैंपेन बनाने या मौजूदा कैंपेन पर COMMISSION बिडिंग की रणनीति लागू करने के अनुरोध करने पर, BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED गड़बड़ी होगी. हालांकि, COMMISSION बिडिंग की रणनीति वाले मौजूदा कैंपेन 31 अक्टूबर, 2024 तक चलते रहेंगे. इस दिन के बाद कैंपेन तब तक विज्ञापन नहीं दिखाएंगे, जब तक कि उनकी बिडिंग की रणनीति अपडेट नहीं की जाती.