पेश है Google Ads API Developer Assistant का 3.0.0 वर्शन

बुधवार, 10 जून, 2026

हमें Google Ads API डेवलपर असिस्टेंट के v3.0.0 को रिलीज़ करने का एलान करते हुए खुशी हो रही है. यह रिलीज़, Assistant के विकास में एक अहम पड़ाव है. इसमें आर्किटेक्चर को आधुनिक बनाने, विश्वसनीयता को बेहतर बनाने, और ज़्यादा मॉड्यूलर डिज़ाइन पर ध्यान दिया गया है.

इस रिलीज़ के साथ, हम Assistant को Google Antigravity एजेंट फ़्रेमवर्क पर माइग्रेट कर रहे हैं. साथ ही, स्किल पर आधारित आर्किटेक्चर पर स्विच कर रहे हैं. इन बदलावों से Assistant को बेहतर बनाया जा सकेगा और उसे मैनेज करना आसान हो जाएगा. साथ ही, टोकन का इस्तेमाल कम हो जाएगा.

v3.0.0 में नया क्या है?

1. Antigravity फ़्रेमवर्क की मदद से काम करता है

Google Ads API डेवलपर असिस्टेंट को gemini-cli से Antigravity एजेंट फ़्रेमवर्क (v3.0.0) पर माइग्रेट कर दिया गया है. इस अपग्रेड से, स्क्रिप्ट को ज़्यादा व्यवस्थित और भरोसेमंद तरीके से चलाने की सुविधा मिलती है. इसके साथ ही, प्रोजेक्ट की डायरेक्ट्री और फ़ाइल स्ट्रक्चर को अपडेट किया गया है, ताकि यह Antigravity के साथ पूरी तरह से काम कर सके.

gemini-cli के लिए सहायता 18 जून, 2026 को खत्म हो जाएगी. इस बारे में ज़्यादा जानकारी, Google के ब्लॉग पर की गई इस सूचना में दी गई है.

2. मॉड्यूलर और स्किल पर आधारित आर्किटेक्चर

हमने Assistant की मुख्य सुविधाओं को स्किल में बदल दिया है. Assistant अब ज़रूरत पड़ने पर, खास तौर पर तैयार की गई और टेस्ट की गई टूल डायरेक्ट्री (स्किल) को डाइनैमिक तौर पर लोड करता है. इसके लिए, वह कॉन्टेक्स्ट फ़ाइल में मौजूद सामान्य और बिना स्ट्रक्चर वाले निर्देशों पर निर्भर नहीं रहता. इससे "गलत जानकारी" देने की संभावना काफ़ी कम हो जाती है. साथ ही, यह पक्का होता है कि टास्क सटीक और पुष्टि की गई प्रक्रियाओं का इस्तेमाल करके पूरे किए जाएं.

इस मॉड्यूलर ट्रांज़िशन में ये मुख्य अपडेट शामिल हैं:

  • GAQL की पुष्टि (validate_gaql): इसे एक खास स्किल में बदल दिया गया है. अब इसमें तारीख के सेगमेंट, click_view एक दिन के फ़िल्टर, और change_status सीमाओं के लिए, बेहतर स्टैटिक क्वेरी की जांच शामिल है.
  • कन्वर्ज़न से जुड़ी समस्याएं हल करना (troubleshoot_conversions): यह पुराने conversions_support_package की जगह लेगा. यह कन्वर्ज़न से जुड़ी समस्या हल करने और अपलोड की गई समरी स्क्रिप्ट को एक साथ इकट्ठा करता है. साथ ही, टेस्ट को एक ही स्किल डायरेक्ट्री में इकट्ठा करता है.
  • स्ट्रक्चर्ड कमांड (explain और step_by_step): इन्हें स्किल में बदल दिया गया है, ताकि जवाबों के लिए एक जैसा और स्ट्रक्चर्ड लेआउट लागू किया जा सके.
  • खाते की नई मैपिंग (get_cids_under_mcc): मैनेजर खाते (एमसीसी) के तहत सभी चाइल्ड खातों को वापस पाने की नई सुविधा.
  • ऑब्जेक्ट की नई जांच (inspect_object): यह एक नई स्किल है. इसकी मदद से, Protobuf मैसेज और Enum को डाइनैमिक तौर पर तुरंत खोजा जा सकता है. इससे यह पक्का करने में मदद मिलती है कि Assistant हमेशा सही स्ट्रक्चर का इस्तेमाल करे.
  • नया PMax लिस्टिंग फ़िल्टर (pmax_listing_filter): परफ़ॉर्मेंस मैक्स कैंपेन के लिए, लिस्टिंग ग्रुप के वेबपेज एक्सक्लूज़न ट्री में किए जाने वाले बदलावों को स्टैंडर्ड बनाने के लिए एक नई स्किल.

3. ज़्यादा बेहतर और सटीक नतीजे

हमने कोड जनरेट करने और क्वेरी की पुष्टि करने की प्रोसेस को बेहतर बनाने के लिए, ज़्यादा सख्त नियम और ज़रूरी शर्तें लागू की हैं:

  • एपीआई के वर्शन की साफ़ तौर पर जानकारी: get_cids_under_mcc, validate_gaql, और troubleshoot_conversions जैसी अहम स्किल के लिए, अब साफ़ तौर पर api_version आर्ग्युमेंट की ज़रूरत होती है. इससे किसी भी तरह की गड़बड़ी की संभावना नहीं रहती.
  • GAQL के सख्त नियम:
    • AGENTS.md में एक नियम जोड़ा गया है, ताकि GAQL क्वेरी में एसक्यूएल एग्रीगेट फ़ंक्शन (जैसे कि SUM, COUNT, और AVG) का इस्तेमाल न किया जा सके. ऐसा इसलिए, क्योंकि ये फ़ंक्शन GAQL क्वेरी के साथ काम नहीं करते.
    • एपीआई के मौजूदा वर्शन के लिए, सबसे पहले Google Ads API डेवलपर साइट के रिलीज़ नोट देखने का नियम जोड़ा गया है. इससे यह पक्का किया जा सकेगा कि Assistant, अप-टू-डेट दस्तावेज़ का इस्तेमाल करे.
    • बेहतर कॉन्फ़िगरेशन: AGENTS.md को बेहतर बनाया गया है. इससे शुरुआती कॉन्टेक्स्ट विंडो छोटी हो गई है. डुप्लीकेट कन्वर्ज़न से जुड़े दस्तावेज़ को हटा दिया गया है, ताकि प्रोग्रामैटिक स्किल को बढ़ावा दिया जा सके.

4. डेवलपर एक्सपीरिएंस (डीएक्स) में सुधार

हमने आपके डेवलपमेंट लूप को तेज़ और आसान बनाने के लिए, कई सुधार किए हैं:

  • परसिस्टेंट वर्चुअल एनवायरमेंट (.venv): सेशन खत्म होने पर, वर्चुअल एनवायरमेंट अब नहीं मिटता. Assistant, स्टार्टअप के दौरान आपके सिस्टम के Python वर्शन की जांच करता है. अगर Python का नया वर्शन उपलब्ध होता है, तो यह सिर्फ़ .venv को फिर से बनाता है.
  • Google Ads API वर्शन की स्मार्ट कैशिंग: Assistant अब Google Ads API के मौजूदा वर्शन को 19 घंटे के TTL के साथ कैश मेमोरी में सेव करती है. इससे स्टार्टअप में लगने वाला समय कम हो जाता है, क्योंकि नेटवर्क की बार-बार जांच नहीं करनी पड़ती.
  • लॉग मैसेज की मदद से गड़बड़ी को बेहतर तरीके से ठीक करना: लॉग मैसेज में अब तारीख और समय के स्टैंप शामिल होते हैं. लॉग फ़ाइल को .agents/ डायरेक्ट्री में सेव किया जाता है. साथ ही, हर बार प्रोग्राम चलाने पर इसे रीसेट नहीं किया जाता. इससे समस्या हल करने के लिए इतिहास को सेव रखा जाता है.

आपको अपग्रेड क्यों करना चाहिए?

v3.0.0 में अपग्रेड करने का मुख्य मकसद, भरोसेमंद और व्यवस्थित बनाना है. Assistant को Antigravity फ़्रेमवर्क पर माइग्रेट करके और इसकी सुविधाओं को स्किल में बांटकर, हमने इसे ज़्यादा भरोसेमंद और कम रिसॉर्स इस्तेमाल करने वाला बनाया है.

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

शुरू करें

पहली बार इंस्टॉल करना

  1. Antigravity CLI इंस्टॉल करें: https://antigravity.google/ पर दिए गए निर्देशों का पालन करें.
  2. Assistant को क्लोन करना: 
    git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  3. इंस्टॉल स्क्रिप्ट चलाएं:
    • Linux/macOS: ./install.sh चलाएं (यह डिफ़ॉल्ट रूप से Python के साथ काम करता है. अन्य भाषाओं के लिए, --php या --ruby जैसे फ़्लैग इस्तेमाल करें).
    • Windows: PowerShell खोलें और .\install.ps1 चलाएं.

v2.x से अपग्रेड करना

  1. saved/ से किसी भी कस्टम कोड या डेटा को प्रोजेक्ट डायरेक्ट्री के बाहर किसी सुरक्षित जगह पर कॉपी करें.
  2. Assistant का लोकल क्लोन मिटाएं.
  3. डेटाबेस को क्लोन करें:
git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  1. नए Antigravity एनवायरमेंट को शुरू करने के लिए, इंस्टॉल स्क्रिप्ट (install.sh या install.ps1) चलाएं.

बॉब हैंकॉक, Google Ads API टीम

Labels: google-ads-api, release