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

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

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

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

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

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

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

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 डेवलपर असिस्टेंट, "डेवलपर बनाम एपीआई" की समस्या को "डेवलपर + एआई" के सहयोग में बदल देती है. इससे सुरक्षित, मुहावरेदार, और आर्किटेक्चर के हिसाब से सही कोड तैयार होता है.

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

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

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

अगले चरण

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