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

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

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

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

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 को इंस्टॉल और इस्तेमाल करना