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

गुरुवार, 26 फ़रवरी, 2026

इस खास अपडेट के बाद, Assistant अब कोड जनरेट करने वाले एक बेहतरीन टूल के साथ-साथ, Google Ads डेवलपर के लिए समस्या हल करने और ऑटोमेशन में मदद करने वाला एक बेहतरीन पार्टनर भी बन गया है. v1.6.0 रिलीज़ होने के बाद से, हमने आपके सुझावों पर ध्यान दिया है. साथ ही, एपीआई डेवलपमेंट के सबसे मुश्किल हिस्सों पर फ़ोकस किया है: डाइग्नोस्टिक्स, एक जैसा अनुभव, और सेटअप.

v2.0 में नया क्या है?

1. इंस्टॉल करना और रखरखाव करना आसान है

कई भाषाओं वाला डेवलपमेंट एनवायरमेंट सेट अप करना कोई मुश्किल काम नहीं है.

• एक कमांड से सेटअप: pip, composer, और bundler डिपेंडेंसी को एक बार में मैनेज करने के लिए, install.sh या install.ps1 के साथ नए --install-deps फ़्लैग का इस्तेमाल करें.
• एक जैसी डायरेक्ट्री स्ट्रक्चर: जनरेट किया गया सारा कोड, एक्सपोर्ट की गई CSV फ़ाइलें, और डाइग्नोस्टिक रिपोर्ट अब एक ही saved/ डायरेक्ट्री में व्यवस्थित की जाती हैं. इसमें हर तरह के आउटपुट के लिए सब-डायरेक्ट्री होती हैं.
• एक कमांड से अपडेट करना: एपीआई और क्लाइंट लाइब्रेरी का नया वर्शन रिलीज़ होने पर, आपको नए वर्शन का इस्तेमाल करने के लिए update.sh को लागू करना होगा. अपने कॉन्टेक्स्ट में अन्य क्लाइंट लाइब्रेरी जोड़ने के लिए, update.sh का भी इस्तेमाल किया जा सकता है.

2. एजेंटिक कन्वर्ज़न से जुड़ी समस्या हल करना

ऑफ़लाइन कन्वर्ज़न ट्रैकिंग, Google Ads API की सबसे असरदार और जटिल सुविधाओं में से एक है. कन्वर्ज़न एट्रिब्यूट न होने की वजह का पता लगाना, एक मैन्युअल प्रोसेस है जिसमें समय लग सकता है.

v2.0 में, हमने कन्वर्ज़न से जुड़ी समस्या हल करने और डाइग्नोस्टिक्स के लिए एक खास सुइट लॉन्च किया है.

• नई स्क्रिप्ट: api_examples/collect_conversions_troubleshooting_data.py
• नया निर्देश: /conversions_support_data

यह स्क्रिप्ट, कन्वर्ज़न से जुड़ी समस्या हल करने के लिए स्टैंडर्ड रिपोर्ट जनरेट करती है. साथ ही, Assistant को आपकी समस्याओं को हल करने के लिए ज़रूरी जानकारी देती है.

यह कमांड तब सबसे ज़्यादा काम आता है, जब Assistant ने कन्वर्ज़न से जुड़ी आपकी समस्या का विश्लेषण कर लिया हो और उसे हल करने की कोशिश की हो. अगर ऐसा नहीं हो पाता है और आपको सहायता टीम से संपर्क करना है, तो यह कमांड आपके ग्राहक की सेटिंग, कन्वर्ज़न ऐक्शन, और अपलोड की गई खास जानकारी का विश्लेषण करेगा. इससे, पहले से किए गए विश्लेषण के आधार पर, स्ट्रक्चर्ड डाइग्नोस्टिक रिपोर्ट जनरेट होगी. यह "खराब" स्थितियों और गड़बड़ी की ज़्यादा दरों का अपने-आप पता लगाता है. इससे आपको लॉग की जांच करने में घंटों नहीं बिताने पड़ते. यह नतीजों को एक टेक्स्ट फ़ाइल में सेव करता है. अगर आपको सहायता का अनुरोध करना है, तो इस फ़ाइल को अनुरोध के साथ शामिल किया जा सकता है.

3. नए एपीआई (v23) के लिए बनाया गया

वर्शन 2.0 में, Google Ads API v23 पूरी तरह से काम करता है. इंटरैक्टिव तरीके से सीखने के लिए उपलब्ध सभी उदाहरणों को अपडेट कर दिया गया है. साथ ही, Assistant के इंटरनल कॉन्टेक्स्ट को नए संसाधनों और फ़ील्ड के लिए ऑप्टिमाइज़ कर दिया गया है. इससे यह पक्का होता है कि जनरेट किया गया कोड, प्रोडक्शन के लिए तैयार है.

4. सेशन हुक की मदद से आसान ऑटोमेशन

हमने SessionStart और SessionEnd हुक जोड़े हैं, ताकि आपके वर्कफ़्लो में कोई रुकावट न आए.

• ऑटोमैटिक कॉन्फ़िगरेशन: Assistant अब सेशन की शुरुआत में, आपकी $HOME डायरेक्ट्री में कॉन्फ़िगरेशन फ़ाइल का अपने-आप पता लगा सकती है. यह इसे आपकी प्रोजेक्ट डायरेक्ट्री में मौजूद सब-डायरेक्ट्री config में कॉपी करता है. एपीआई से क्वेरी करने के लिए, Gemini की पसंदीदा भाषा Python है. इसलिए, अगर किसी दूसरी भाषा का इस्तेमाल किया जा रहा है, तो यह आपकी कॉन्फ़िगरेशन फ़ाइल को पढ़ता है और अपनी क्वेरी के लिए कॉन्फ़िगरेशन में एक अस्थायी google-ads.yaml बनाता है. हालांकि, यह आपकी पसंदीदा भाषा के कोड में जवाब देना जारी रखता है.
• अपने-आप क्लीनअप होने की सुविधा: सेशन से बाहर निकलने पर, अस्थायी कॉन्फ़िगरेशन सुरक्षित तरीके से मिटा दिए जाते हैं. इससे आपका वर्कस्पेस साफ़-सुथरा रहता है और आपके क्रेडेंशियल सुरक्षित रहते हैं.

5. GAQL की पुष्टि करने की स्मार्ट सुविधा

मुश्किल GAQL क्वेरी बनाना अब पहले से कहीं ज़्यादा आसान हो गया है. हमने GEMINI.md और conversions/GEMINI.md को अपडेट किया है. इनमें एपीआई के सबसे नए एज केस के लिए, पुष्टि करने के सख्त नियम शामिल किए गए हैं. इनमें तारीख के सेगमेंट को बेहतर तरीके से मैनेज करना और सीमित रेंज की ज़रूरी शर्तें शामिल हैं. Assistant अब क्वेरी को चलाने से पहले ही, लॉजिक से जुड़ी गड़बड़ियों का पता लगा लेता है.

6. स्किल

स्किल को एक मिनी-प्लग इन या "व्यवहार का ब्लूप्रिंट" माना जा सकता है. सामान्य कॉन्टेक्स्ट (जैसे कि आपकी GEMINI.md फ़ाइल) से बैकग्राउंड की जानकारी मिलती है. वहीं, एआई के दिमाग़ में कोई स्किल सिर्फ़ तब "लोड" होती है, जब उसे कोई जटिल और सिलसिलेवार टास्क करना होता है. जैसे, इस एक्सटेंशन का मौजूदा वर्शन पाना. स्किल को सीधे तौर पर लागू नहीं किया जाता. Gemini यह तय करता है कि उसे कब इस सुविधा की ज़रूरत है.

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

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

v1.6.0 से v2.0.0 पर अपग्रेड करने का मतलब सिर्फ़ नई सुविधाएं पाना नहीं है, बल्कि यह भरोसेमंद होने के बारे में भी है. एपीआई के बारे में ज़्यादा जानकारी को ऑटोमेटेड डाइग्नोस्टिक टूल के साथ इंटिग्रेट करके, v2.0 "ट्रायल और गड़बड़ी" के लूप को कम करता है. इस लूप की वजह से, एपीआई इंटिग्रेशन की प्रोसेस अक्सर धीमी हो जाती है.

चाहे आपको कन्वर्ज़न अपलोड को डीबग करना हो या जटिल रिपोर्टिंग पाइपलाइन बनानी हों, v2.0 आपको तेज़ी से और ज़्यादा भरोसे के साथ काम करने के लिए टूल देता है.

शुरू करना

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

• git clone https://github.com/googleads/google-ads-api-developer-assistant.git
• प्रोजेक्ट डायरेक्ट्री में, install.sh या install.ps1 चलाएं, ताकि एक्सटेंशन और क्लाइंट लाइब्रेरी इंस्टॉल की जा सकें.

पिछले वर्शन से अपग्रेड करना

• saved_code/ और saved_csv/ से किसी भी कस्टम कोड को किसी सुरक्षित जगह पर कॉपी करें.
• अपनी प्रोजेक्ट डायरेक्ट्री और सभी सब-डायरेक्ट्री और फ़ाइलों को मिटाकर, Google Ads API Developer Assistant के लोकल क्लोन को मिटाएं.
• git clone https://github.com/googleads/google-ads-api-developer-assistant.git
• प्रोजेक्ट डायरेक्ट्री में, install.sh या install.ps1 चलाएं, ताकि एक्सटेंशन और क्लाइंट लाइब्रेरी इंस्टॉल की जा सकें.

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

Labels: google-ads-api, release