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

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

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

Assistant से बातचीत करने के लिए, सामान्य और स्वाभाविक भाषा में सवाल पूछे जा सकते हैं और अनुरोध किए जा सकते हैं. 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 डेवलपर असिस्टेंट, इस समस्या को हल करती है. इसके लिए, वह Google Ads API के आर्किटेक्चर से जुड़े नियमों को, डाइनैमिक और स्थानीय Protobuf स्कीमा की जांच के साथ जोड़ती है:

  • डिटरमिनिस्टिक पुष्टि: इसमें, कई राउंड-ट्रिप में एलएलएम के अनुमान पर भरोसा करने के बजाय, Assistant चार चरणों वाली स्थानीय पुष्टि की पाइपलाइन चलाता है. यह पाइपलाइन, एक ही चरण में फ़ील्ड के साथ काम करने की क्षमता, संसाधन के संबंध, ज़ीरो-इंप्रेशन के नियमों, और तारीख के सेगमेंट की पुष्टि करती है.
  • वर्शन के हिसाब से सटीक स्कीमा लुकअप: यह सुविधा, चालू एपीआई वर्शन के लिए आधिकारिक एपीआई स्कीमा से सीधे तौर पर 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 क्या-क्या कर सकती है

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

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

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

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

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

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

अगले चरण

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