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

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

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

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

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

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

अगले चरण

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