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

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

  • एक बार में ज़्यादा से ज़्यादा तीन मुख्य वर्शन उपलब्ध होते हैं.
  • मेजर वर्शन करीब 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.v17.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: 27.0.0

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 तक चलते रहेंगे. इस दिन से, जब तक बिडिंग की रणनीति अपडेट नहीं की जाती, तब तक कैंपेन नहीं दिखाए जाएंगे.