Google Ads API डेवलपर असिस्टेंट क्या है?

Google Ads API Developer Assistant (v4.0.0) कोई सामान्य चैटबॉट नहीं है. यह एआई की मदद से काम करता है विज्ञापन इंजीनियरिंग के लिए, खास तौर पर बनाया गया मिशन कंट्रोल सिस्टम है. इसे Google Antigravity और Claude Code एजेंट फ़्रेमवर्क पर बनाया गया है.

नैचुरल लैंग्वेज में सवाल-जवाब और कारोबार से जुड़ा कॉन्टेक्स्ट

Assistant से बातचीत करने के लिए, आसान और नैचुरल लैंग्वेज में सवाल पूछे जा सकते हैं और अनुरोध किए जा सकते हैं. असिस्टेंट आपके मकसद का विश्लेषण करता है, आधिकारिक एपीआई स्कीमा से सलाह लेता है, और साफ़ तौर पर जानकारी, प्रोडक्शन के लिए तैयार कोड या लाइव डेटा उपलब्ध कराता है:

  • नैचुरल लैंग्वेज में जवाब: Google Ads API के कॉन्सेप्ट, रिसॉर्स की हैरारकी, रिपोर्टिंग मेट्रिक या सेगमेंटेशन के नियमों के बारे में सवाल पूछें. इससे आपको साफ़ और कॉन्सेप्ट के हिसाब से खास जानकारी और आर्किटेक्चर के बारे में जानकारी मिलेगी.
  • टारगेट किया गया कोड जनरेट करना: जब आपके टास्क को लागू करने की ज़रूरत होती है, तब Assistant आपकी प्रोग्रामिंग लैंग्वेज और इस्तेमाल के उदाहरण के हिसाब से, मुहावरेदार, प्रोडक्शन के लिए तैयार क्लाइंट लाइब्रेरी कोड स्निपेट, म्यूटेशन स्क्रिप्ट या GAQL क्वेरी उपलब्ध कराता है.
  • समस्या हल करना और गड़बड़ी का पता लगाना: एपीआई से जुड़ी गड़बड़ी के मैसेज, gRPC स्टेटस कोड या इंटिग्रेशन से जुड़ी गड़बड़ियां पेस्ट करें. असिस्टेंट, समस्या की असल वजह का पता लगाता है और बताता है कि समस्या क्यों हुई. साथ ही, कोड में ज़रूरी सुधार करता है या कॉन्फ़िगरेशन से जुड़ी गड़बड़ियां ठीक करता है.
  • ज़रूरत के हिसाब से रिपोर्टिंग: आसान भाषा में, खाते की परफ़ॉर्मेंस का डेटा और कैंपेन मेट्रिक का अनुरोध करें. Assistant, सीधे आपके खाते के लिए GAQL क्वेरी बनाती है, उनकी पुष्टि करती है, और उन्हें चलाती है. साथ ही, आपके टर्मिनल में फ़ॉर्मैट किए गए नतीजे दिखाती है या उन्हें CSV फ़ाइल में एक्सपोर्ट करती है.
  • आपके कोड बेस से कारोबार के हिसाब से कॉन्टेक्स्ट: --context_dir सेटअप पैरामीटर का इस्तेमाल करके, अपनी प्रोजेक्ट रिपॉज़िटरी और कोड बेस को रजिस्टर करें. असिस्टेंट, आपके मौजूदा डेटा पाइपलाइन, सहायक यूटिलिटी, और कारोबारी नियमों का विश्लेषण करता है. इसके बाद, वह आपके इंटरनल सिस्टम के साथ आसानी से इंटिग्रेट करने के लिए, कोड जनरेट करता है. साथ ही, कोड से जुड़ी जानकारी और समस्या हल करने के तरीके बताता है.

बड़ी तस्वीर: नियमों के पालन से जुड़ी समस्याओं को हल करना

यह असिस्टेंट, कॉग्निटिव ओवरलोड और तकनीकी समस्याओं को हल करता है.

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

Assistant ने इस समस्या को 4.0.0 वर्शन में हल कर दिया है. इसके लिए, उसने मॉड्यूलर प्लगिन आर्किटेक्चर को पेश किया है. यह आर्किटेक्चर, खास तौर पर टेस्ट की गई स्किल और पहले से मौजूद स्लैश कमांड की मदद से काम करता है. यह एक ऑटोमेटेड एक्सपर्ट मिडलवेयर के तौर पर काम करता है. यह वर्शन की पुष्टि करने, स्कीमा खोजने, और कोड लिंट करने जैसे मुश्किल काम करता है. इससे डेवलपर, सिंटैक्स के बजाय इंटेंट के लेवल पर काम कर पाता है.

यह आधिकारिक स्कीमा पर आधारित है, न कि अनुमान पर

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

Google Ads API Developer Assistant, इस समस्या को हल करता है. इसके लिए, यह Google Ads API के आर्किटेक्चर से जुड़े नियमों को डाइनैमिक और लोकल Protobuf स्कीमा की जांच के साथ जोड़ता है:

  • डिटरमिनिस्टिक वैलिडेशन: कई राउंड-ट्रिप में एलएलएम के बार-बार अनुमान लगाने पर भरोसा करने के बजाय, असिस्टेंट चार चरणों वाली एक लोकल वैलिडेशन पाइपलाइन चलाता है. यह पाइपलाइन, फ़ील्ड के साथ काम करने की क्षमता, संसाधन के संबंधों, ज़ीरो-इंप्रेशन के नियमों, और तारीख के सेगमेंटेशन की पुष्टि एक ही चरण में करती है.
  • वर्शन के हिसाब से सटीक स्कीमा लुकअप: यह चालू एपीआई वर्शन के लिए, आधिकारिक एपीआई स्कीमा से सीधे Protobuf रिसॉर्स की परिभाषाओं, डेटा टाइप, और enum वैल्यू की जांच करता है. इससे बार-बार रिमोट मेटाडेटा क्वेरी करने की ज़रूरत नहीं पड़ती.
  • आधिकारिक क्लाइंट लाइब्रेरी ग्राउंडिंग: कोड जनरेशन, Python, Java, PHP, .NET, और Ruby में Google Ads की आधिकारिक क्लाइंट लाइब्रेरी पर आधारित होता है.

उदाहरण: खास रिसर्च और डाइग्नोस्टिक लैब

इस असिस्टेंट को किसी सर्जन के लिए हाई-टेक रिसर्च लैब की तरह समझें.

  • सर्जन (डेवलपर): आपको पता होता है कि कौनसी प्रोसेस करनी है. उदाहरण के लिए, "मुझे परफ़ॉर्मेंस मैक्स कैंपेन की परफ़ॉर्मेंस का विश्लेषण करना है".
  • लैब के उपकरण (एपीआई): ये सर्जरी करने के लिए ज़रूरी दमदार टूल हैं. हालांकि, ये काफ़ी जटिल होते हैं और इन्हें सटीक तरीके से कैलिब्रेट करना ज़रूरी होता है.
  • लैब असिस्टेंट (यह टूल): मरीज़ को छूने से पहले, लैब असिस्टेंट खास स्किल और पहले से मौजूद निर्देशों का इस्तेमाल करके:
    1. मैन्युअल देखें: यह टूल, नए एपीआई प्रोटोकॉल की अपने-आप पुष्टि करता है और रिसॉर्स स्ट्रक्चर की तुरंत जांच करता है (inspect_object / /inspect-object).
    2. टूल की पहले से जांच करना: यह लाइव एपीआई की पुष्टि (validate_gaql / /validate-gaql) का इस्तेमाल करके, आपकी क्वेरी पर डिटरमिनिस्टिक ड्राय रन चलाता है, ताकि गड़बड़ियां होने से पहले ही उन्हें पकड़ा जा सके.
    3. कोड को साफ़ करना: यह सुविधा, लिंटर पाइपलाइन (ruff लिंटिंग) का इस्तेमाल करके, आपके कोड को फ़ॉर्मैट और साफ़ करती है, ताकि सिस्टम में गड़बड़ियां न हों.
    4. ज़रूरी मेट्रिक को मॉनिटर करना: यह एपीआई से जुड़ी गड़बड़ियों पर नज़र रखता है. साथ ही, ऑफ़लाइन कन्वर्ज़न (troubleshoot_conversions / /troubleshoot-conversions) जैसे जटिल कामों के लिए, बेहतर डाइग्नोस्टिक वर्कफ़्लो चलाता है.
    5. कॉन्सेप्ट समझाना: यह मुश्किल कॉन्सेप्ट को आम बोलचाल की भाषा में समझाता है. इसके लिए, यह असल दुनिया के उदाहरणों का इस्तेमाल करता है (/explain, /step-by-step, /assistant-tutorial).

एक-दूसरे से जुड़ाव: "सुरक्षा सबसे पहले" का सिद्धांत

Assistant, आपके प्रोजेक्ट में चार अलग-अलग "दुनियाओं" को जोड़ने वाले पुल के तौर पर काम करती है. इन दुनियाओं को कंट्रोल करने वाले कॉन्ट्रैक्ट (AGENTS.md / CLAUDE.md) से नियंत्रित किया जाता है:

  • उपयोगकर्ता का कॉन्टेक्स्ट: यह आपके बड़े लक्ष्यों को समझता है और उन्हें तकनीकी रणनीति में बदलता है.
  • लोकल वर्कस्पेस: यह आपकी प्रोजेक्ट डायरेक्ट्री में "आंखों और हाथों" की तरह काम करता है. यह मौजूदा कोड को पढ़ सकता है और बाद में इस्तेमाल करने के लिए नया कोड लिख सकता है. साथ ही, यह कोड को पूरी तरह से अलग रखता है.
  • Google Ads API: यह लाइव एपीआई से कनेक्ट होता है, ताकि आपके खाते के लिए सिर्फ़ पढ़ने के लिए उपलब्ध रिपोर्ट और टेस्ट क्वेरी चलाई जा सकें. फ़ील्ड की तेज़ी से पुष्टि करने के लिए, यह सीधे तौर पर लोकल Protobuf स्कीमा की जांच करता है.
  • सुरक्षा के गेटकीपर: इसे सख्त प्रोटोकॉल का पालन करने के लिए प्रोग्राम किया गया है. अगर किसी स्क्रिप्ट को लिंट नहीं किया गया है, तो यह उसे चलाने की अनुमति नहीं देगा. साथ ही, अगर किसी क्वेरी की प्रोग्राम के हिसाब से पुष्टि नहीं की गई है, तो यह उसे भेजने की अनुमति नहीं देगा.

Assistant क्या-क्या करती है

आसान शब्दों में कहें, तो असिस्टेंट आपकी सुरक्षा करता है और आपके काम को तेज़ी से पूरा करने में मदद करता है.

  • इससे गलतियां नहीं होतीं: यह कोड और क्वेरी को लागू करने से पहले, चालू एपीआई स्कीमा के हिसाब से उनकी पुष्टि करता है. इससे सिंटैक्स और काम न करने से जुड़ी गड़बड़ियां, लाइव एपीआई तक पहुंचने से पहले ही रुक जाती हैं.
  • इसे मैप की जानकारी होती है: इसे Google Ads API के भूगोल की जानकारी होती है. जैसे, डेटा कहां मौजूद है और बेहतर तरीके से क्वेरी कैसे की जाए.
  • यह उबाऊ कामों को ऑटोमेट करता है: यह बॉयलरप्लेट क्लाइंट लाइब्रेरी कोड लिखता है, रिपोर्ट को साफ़ टर्मिनल टेबल में फ़ॉर्मैट करता है, और क्लाइंट लाइब्रेरी प्लंबिंग को मैनेज करता है.
  • यह मुश्किल वर्कफ़्लो से जुड़ी समस्याएं हल करता है: यह ऑफ़लाइन कन्वर्ज़न अपलोड पर डीप डाइग्नोस्टिक चलाता है, मैनेजर खाते की हैरारकी से जुड़ी समस्याएं हल करता है, और मुश्किल कैंपेन स्ट्रक्चर को कॉन्फ़िगर करता है. जैसे, परफ़ॉर्मेंस मैक्स कैंपेन के लिस्टिंग फ़िल्टर और बाहर रखे जाने वाले यूआरएल.
  • यह लाइव ऐड हॉक रिपोर्ट स्ट्रीम करता है: परफ़ॉर्मेंस डेटा के बारे में अंग्रेज़ी में पूछें. इसके बाद, असिस्टेंट आपके खाते के लिए GAQL क्वेरी बनाता है, उनकी पुष्टि करता है, और उन्हें चलाता है. साथ ही, फ़ॉर्मैट किए गए नतीजों को आपके टर्मिनल पर स्ट्रीम करता है या उन्हें CSV फ़ाइल में एक्सपोर्ट करता है.
  • यह अप-टू-डेट रहता है: यह एपीआई के चालू वर्शन के लिए, लोकल Protobuf स्कीमा और दस्तावेज़ों की जांच करता है. इससे आपको ऐसे फ़ील्ड और नियमों से बचने में मदद मिलती है जो अब काम नहीं करते.

Google Ads API Developer Assistant, "डेवलपर बनाम एपीआई" की समस्या को "डेवलपर + एआई" के सहयोग में बदल देता है. इससे सुरक्षित, मुहावरेदार, और आर्किटेक्चर के हिसाब से सही कोड जनरेट होता है.

आर्किटेक्चर और परफ़ॉर्मेंस (v4.0.0)

वर्जन 4.0.0 में, असिस्टेंट को स्टैंडअलोन प्रोजेक्ट सेटअप से एक मॉडर्न और ग्लोबल प्लगिन आर्किटेक्चर में बदल दिया गया है:

  • ज़ीरो डीमन ओवरहेड: स्किल और डाइग्नोस्टिक कमांड, कॉल किए जाने पर ही कुछ समय के लिए लाइटवेट चाइल्ड प्रोसेस के तौर पर चलते हैं. इससे, इस्तेमाल न होने पर सिस्टम के संसाधनों का इस्तेमाल शून्य हो जाता है.
  • ज़रूरत के हिसाब से कॉन्टेक्स्ट उपलब्ध कराना: नियम और स्कीमा, सिर्फ़ तब लोड किए जाते हैं, जब वे आपके मौजूदा टास्क के लिए ज़रूरी हों. इससे टोकन का इस्तेमाल और प्रॉम्प्ट के जवाब में लगने वाला समय काफ़ी कम हो जाता है.
  • डिस्क के इनपुट/आउटपुट को कम करना: प्लगिन ट्री से SDK टूल की ग़ैर-ज़रूरी फ़ाइलों को हटाने से, IDE इंडेक्स करने वाले टूल, लिंटर, और फ़ाइल वॉचर को इस्तेमाल न की गई हज़ारों फ़ाइलों को स्कैन करने से रोका जा सकता है.
  • मल्टी-प्लैटफ़ॉर्म होस्ट के साथ काम करता है: यह Google Antigravity और Claude Code के एनवायरमेंट में आसानी से काम करता है. इसके लिए, Linux, macOS, और Windows पर यूनिफ़ाइड इंस्टॉलेशन स्क्रिप्ट का इस्तेमाल किया जाता है.

अगले चरण

आगे बढ़ें
Google Ads API Developer Assistant को इंस्टॉल और इस्तेमाल करना