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

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

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

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

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

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

API वर्शन रिलीज़ की तारीख बंद होने की तारीख बंद होने की तारीख अपग्रेड करने के लिए गाइड
v18 16 अक्टूबर, 2024 फ़रवरी 2025 24 सितंबर, 2025
v17.1 7 अगस्त, 2024 16 अक्टूबर, 2024 4 जून, 2025 v17 से v18 पर अपग्रेड करना
v17 5 जून, 2024 16 अक्टूबर, 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. METRICS सब-टैब में, आपको हर ग्राफ़ पर अपने हाल ही के अनुरोध दिखेंगे. तरीके टेबल में जाकर, यह देखा जा सकता है कि आपने किन तरीकों से अनुरोध भेजे हैं. तरीके के नाम में, Google Ads API का वर्शन, सेवा, और तरीका का नाम शामिल होता है, जैसे कि google.ads.googleads.v18.services.GoogleAdsService.Mutate.
  4. (ज़रूरी नहीं) वह समयावधि चुनें जिसमें आपको अनुरोधों की जानकारी देखनी है.

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

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

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

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

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

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

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

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

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

Java

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

C#

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

PHP

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

Python

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

Ruby

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

Perl

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