बंद होने की प्रक्रिया और बंद होने की तारीख

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

  • एक बार में ज़्यादा से ज़्यादा तीन मुख्य वर्शन उपलब्ध होते हैं.
  • मेजर वर्शन का लाइफ़साइकल करीब 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. मेट्रिक सब-टैब में, आपको हर ग्राफ़ पर अपने हाल ही के अनुरोध दिखेंगे. पेमेंट के तरीके टेबल में जाकर, यह देखा जा सकता है कि आपने किन तरीकों से अनुरोध भेजे हैं. तरीके के नाम में, 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: 34.0.0

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.1
Max: -
v17 Min: 23.0.0
Max: -
v16 Min: 21.0.0
Max: -

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

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

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

सुविधा ब्यौरा लागू होने की तारीख और जानकारी
Google Ads API और Google Ads स्क्रिप्ट की खोज के लिए इस्तेमाल हुए शब्द की अहम जानकारी वाली रिपोर्ट में 3 मार्च, 2025 से होने वाला अपडेट Google Ads API और Google Ads स्क्रिप्ट की, खोज के लिए इस्तेमाल हुए शब्द की अहम जानकारी वाली रिपोर्ट में, 3 मार्च, 2025 से खोज की सभी सबकैटगरी खाली के तौर पर दिखेंगी. Google Ads के यूज़र इंटरफ़ेस (यूआई) ने इस फ़ील्ड को पहले ही हटा दिया है. साथ ही, Google Ads में एक जैसा अनुभव देने के लिए, एपीआई भी इस बदलाव को रोल आउट कर रहा है. 3 मार्च, 2025 उम्मीद है कि 3 मार्च, 2 segments.search_subcategory के बाद, सभी वैल्यू खाली होंगी. अगर आपने campaign_search_term_insight या customer_search_term_insight रिपोर्ट में segments.search_subcategory के लिए क्वेरी की है, तो देखें कि आपका कोड segments.search_subcategory में खाली वैल्यू को हैंडल कर सकता है या नहीं. खाली स्ट्रिंग पहले से ही कैच-ऑल है, इसलिए आपका कोड पहले से ही इसे मैनेज कर रहा होगा. हमारा सुझाव है कि आप अपनी क्वेरी से segments.search_subcategory को हटा दें.
Google Ads API में पेज साइज़ में होने वाले बदलाव वर्शन 16 बंद होने के बाद, GoogleAdsService.Search के अनुरोध करते समय, page_size फ़ील्ड को सेट नहीं किया जा सकेगा. फ़रवरी 2025 वर्शन 16 बंद होने के बाद, सभी GoogleAdsService.Search अनुरोधों के लिए, पेज का साइज़ 10,000 लाइनों का तय रहेगा.
कस्टमर मैच की सदस्यता खत्म होने की तारीख से जुड़ा अपडेट 7 अप्रैल, 2025 से, UserList.membership_life_span फ़ील्ड में 540 से ज़्यादा वैल्यू नहीं डाली जा सकेंगी. 7 अप्रैल, 2025 हम 7 अप्रैल, 2025 से 15 अप्रैल, 2025 तक, UserList.membership_life_span फ़ील्ड में धीरे-धीरे बदलाव रोल आउट करेंगे. फ़ील्ड को 540 से ज़्यादा पर सेट करने के अनुरोधों पर, RangeError.TOO_HIGH वाली गड़बड़ी दिखेगी. अगर किसी मौजूदा उपयोगकर्ता सूची में फ़ील्ड की वैल्यू 540 से ज़्यादा है, तो उसे अपने-आप माइग्रेट कर दिया जाएगा, ताकि सदस्यता की अवधि ज़्यादा से ज़्यादा 540 दिन की हो. ज़्यादा जानकारी के लिए, कस्टमर मैच की सदस्यता की समयसीमा खत्म होने के बारे में अपडेट देखें.