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

Google Ads API Developer Assistant, Google Ads API के डोमेन की विशेषज्ञता को सीधे आपके एआई कोडिंग एनवायरमेंट में लाता है. क्वेरी बनाने, क्लाइंट लाइब्रेरी का कोड जनरेट करने, सिर्फ़ पढ़ने वाले एपीआई कॉल करने, ऐडहॉक रिपोर्ट स्ट्रीम करने, और इंटिग्रेशन की समस्याओं को हल करने के लिए, नैचुरल लैंग्वेज प्रॉम्प्ट और बिल्ट-इन स्लैश कमांड का इस्तेमाल करें.

Assistant को, Google Antigravity और Claude Code एजेंट फ़्रेमवर्क (वर्शन 4.0.0) के लिए, मॉड्यूलर प्लग इन के तौर पर बनाया गया है. यह लगातार कॉन्टेक्स्ट बनाए रखने, सुरक्षा की मज़बूत सीमाएं तय करने, और अपने-आप पुष्टि करने वाली पाइपलाइन को बनाए रखने के लिए, AGENTS.md और CLAUDE.md कॉन्ट्रैक्ट, बिल्ट-इन स्लैश कमांड, और खास डोमेन स्किल का इस्तेमाल करता है.

ज़रूरी शर्तें

शुरू करने से पहले, पक्का करें कि आपके पास ये चीज़ें हों:

  1. Google Ads API का ऐक्सेस:

    • एक्सप्लोरर ऐक्सेस, बेसिक ऐक्सेस या स्टैंडर्ड ऐक्सेस लेवल वाला Google Cloud प्रोजेक्ट. अपने प्रोजेक्ट के ऐक्सेस लेवल की जांच करने या सही ऐक्सेस लेवल के लिए आवेदन करने के लिए, देखें एपीआई के ऐक्सेस लेवल.
    • Google Ads की कॉन्फ़िगरेशन फ़ाइल. इसे OAuth 2.0 क्रेडेंशियल और ग्राहक आईडी के साथ कॉन्फ़िगर किया गया हो. यह फ़ाइल, आपकी होम डायरेक्ट्री में मौजूद होनी चाहिए. क्लाइंट लाइब्रेरी की कॉन्फ़िगरेशन गाइड देखें .
    • Google Ads API के कॉन्सेप्ट और पुष्टि के बारे में जानकारी.

  2. सॉफ़्टवेयर:

    • Python 3.10 या नया वर्शन इंस्टॉल हो और आपके सिस्टम पाथ पर मौजूद हो. जनरेट किए गए कोड को चलाने और स्थानीय पुष्टि के साइडकार को चलाने के लिए, Python का इस्तेमाल किया जाता है.
    • होस्ट एजेंट प्लैटफ़ॉर्म:
    • Git, आपके सिस्टम पाथ पर इंस्टॉल हो.

शुरू करें

डेटाबेस क्लोन करने, प्लैटफ़ॉर्म के हिसाब से इंस्टॉलेशन स्क्रिप्ट चलाने, अपने क्रेडेंशियल कॉन्फ़िगर करने, और प्लग इन को चालू करने के लिए, यह तरीका अपनाएं.

1. डेटाबेस क्लोन करना

डेटाबेस को अपने लोकल मशीन पर क्लोन करें और प्रोजेक्ट डायरेक्ट्री पर जाएं:

git clone https://github.com/googleads/google-ads-api-developer-assistant
cd google-ads-api-developer-assistant

2. इंस्टॉलेशन स्क्रिप्ट चलाना

अपने टारगेट प्लैटफ़ॉर्म के लिए, इंस्टॉलेशन स्क्रिप्ट चलाएं. डिफ़ॉल्ट रूप से, Python क्लाइंट लाइब्रेरी शामिल होती है. आपके पास अन्य क्लाइंट लाइब्रेरी (--php, --ruby, --java, --dotnet या --all) शामिल करने का विकल्प होता है.

Antigravity

Linux / macOS: ```bash ./install.sh agy

इसके अलावा, अन्य क्लाइंट लाइब्रेरी भी शामिल की जा सकती हैं:

./install.sh agy --java --dotnet ```

Windows (PowerShell): ```powershell .\install.ps1 -Type agy

इसके अलावा, अन्य क्लाइंट लाइब्रेरी भी शामिल की जा सकती हैं:

.\install.ps1 -Type agy -Java -Dotnet ```

Claude Code

Linux / macOS: ```bash ./install.sh claude

इसके अलावा, अन्य क्लाइंट लाइब्रेरी भी शामिल की जा सकती हैं:

./install.sh claude --php --dotnet ```

Windows (PowerShell): ```powershell .\install.ps1 -Type claude

इसके अलावा, अन्य क्लाइंट लाइब्रेरी भी शामिल की जा सकती हैं:

.\install.ps1 -Type claude -Php -Dotnet ```

3. क्रेडेंशियल कॉन्फ़िगर करना

पक्का करें कि आपकी एपीआई कॉन्फ़िगरेशन फ़ाइल (उदाहरण के लिए, google-ads.yaml, google_ads_php.ini या google_ads_config.rb), आपकी $HOME डायरेक्ट्री में मौजूद हो.

(ज़रूरी नहीं) डिफ़ॉल्ट ग्राहक आईडी कॉन्फ़िगर करने के लिए, अपना ग्राहक आईडी नंबर सीधे config/customer_id.txt में डालें. उदाहरण के लिए, 1234567890. इसके अलावा, config/api_version.txt में, एपीआई के चालू वर्शन की जांच की जा सकती है या उसे पिन किया जा सकता है.

4. प्लग्इन चालू करना

  • Antigravity: प्लग इन लोड करने के लिए, Antigravity / agy होस्ट सेशन रीस्टार्ट करें.
  • Claude Code: Claude Code के चालू सेशन में, /reload-plugins चलाएं या claude रीस्टार्ट करें.

5. Assistant के साथ इंटरैक्ट करना

आप नैचुरल लैंग्वेज प्रॉम्प्ट या सीधे अपने टर्मिनल में डेडिकेटेड स्लैश कमांड का इस्तेमाल करके Assistant के साथ इंटरैक्ट कर सकते हैं.

मुख्य सुविधाएं

  • नैचुरल लैंग्वेज में सवाल-जवाब का सेशन: Google Ads API की सुविधाओं, सबसे सही तरीकों या खास संसाधनों के बारे में सवाल पूछें.

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

    • "कैंपेन के कौन-कौनसे टाइप उपलब्ध हैं?"
    • "मैं GAQL में तारीख के हिसाब से फ़िल्टर कैसे करूं?"
    • " click_view और impression_view के बीच का अंतर बताएं."
    • "शेयर किया गया सेट क्या होता है और मैं इसका इस्तेमाल कैसे करूं?"
    • Claude Code के स्लैश कमांड: /explain, /step-by-step, /assistant-tutorial

  • क्लाइंट लाइब्रेरी का कोड जनरेट करना: Google Ads की आधिकारिक क्लाइंट लाइब्रेरी (Python, Java, PHP, .NET, और Ruby) का इस्तेमाल करके, टेस्ट किया गया और सही कोड जनरेट करें.

    • "मुझे ऐसे कैंपेन दिखाएं जिन्हें पिछले 30 दिनों में सबसे ज़्यादा कन्वर्ज़न मिले हैं."
    • "ग्राहक 123-456-7890 के लिए, चालू किए गए सभी विज्ञापन ग्रुप के नाम पाएं."
    • "परफ़ॉर्मेंस मैक्स कैंपेन बनाने के लिए कोड लिखें." जनरेट किया गया कोड, saved/code/ डायरेक्ट्री में सेव किया जाता है.

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

    • Claude Code: /validate-gaql
    • आम बोलचाल वाली भाषा: validate: SELECT campaign.id FROM campaign

  • ऑब्जेक्ट और Protobuf स्कीमा की जांच करना: किसी भी चालू एपीआई वर्शन के लिए, संसाधन के स्ट्रक्चर, नेस्ट किए गए फ़ील्ड, डेटा टाइप, और enum वैल्यू की डाइनैमिक तरीके से जांच करें. इसके लिए, रिमोट मेटाडेटा ओवरहेड की ज़रूरत नहीं होती.

    • Claude Code: /inspect-object <resource_or_enum>
    • आम बोलचाल वाली भाषा: "कैंपेन संसाधन की जांच करें"

  • ऐडहॉक लाइव रिपोर्टिंग और CSV फ़ाइल एक्सपोर्ट करना: परफ़ॉर्मेंस डेटा के लिए, आसान अंग्रेज़ी में सवाल पूछें. Assistant, आपके खाते के ख़िलाफ़ सीधे GAQL क्वेरी बनाता है, उनकी पुष्टि करता है, और उन्हें चलाता है. साथ ही, फ़ॉर्मैट की गई टेबल को टर्मिनल में लाइव स्ट्रीम करता है.

    • "ग्राहक 123-456-7890 के लिए, पिछले महीने लागत के हिसाब से टॉप 5 कीवर्ड दिखाएं."
    • "नतीजों को CSV फ़ाइल के तौर पर सेव करें." यह फ़ाइल, saved/csv/ में एक्सपोर्ट होती है.

  • एपीआई को सीधे तौर पर चलाना और बदलाव करने की सुरक्षा: जनरेट की गई सिर्फ़ पढ़ने वाली स्क्रिप्ट को, मैनेज किए गए वर्चुअल एनवायरमेंट में सीधे तौर पर चलाएं.

    • Assistant से सिर्फ़ यह कहें: "कोड चलाएं" या "स्क्रिप्ट चलाएं".
    • बदलाव करने की सुरक्षा: सुरक्षा के लिए, बदलाव करने वाले ऑपरेशन (बनाना, अपडेट करना, मिटाना) saved/code/ में जनरेट किए जाते हैं. हालांकि, Assistant इन्हें सीधे तौर पर कभी नहीं चलाता. इनकी समीक्षा करें और इन्हें Assistant के बाहर मैन्युअल तरीके से चलाएं.

  • बेहतर डाइग्नोस्टिक्स और कन्वर्ज़न की समस्या हल करना: ऑफ़लाइन कन्वर्ज़न अपलोड करने में होने वाली गड़बड़ियों की जांच करें, अपलोड की जाने वाली फ़ाइलों की पहले से पुष्टि करें, और डाइग्नोस्टिक्स की विस्तृत रिपोर्ट जनरेट करें.

    • Claude Code: /troubleshoot-conversions
    • आम बोलचाल वाली भाषा: "ग्राहक 123-456-7890 के लिए, कन्वर्ज़न की समस्या हल करें." रिपोर्ट, saved/data/ में सेव की जाती हैं.

  • एमसीसी खाते की हैरारकी की मैपिंग: उप-खाते के ग्राहक आईडी पाएं और मैनेजर खाते के तहत, खाते की हैरारकी की मैपिंग करें.

    • Claude Code: /get-cids <manager_cid>
    • आम बोलचाल वाली भाषा: "मैनेजर 123-456-7890 के तहत, सभी क्लाइंट ग्राहक आईडी पाएं"

  • परफ़ॉर्मेंस मैक्स के लिस्टिंग फ़िल्टर और एक्सक्लूज़न: ऐसेट ग्रुप के लिए, प्रॉडक्ट पार्टीशन ट्री और वेबपेज यूआरएल के एक्सक्लूज़न जनरेट करें.

    • Claude Code: /pmax-filter
    • आम बोलचाल वाली भाषा: "मेरे परफ़ॉर्मेंस मैक्स कैंपेन के लिए, वेबपेज एक्सक्लूज़न फ़िल्टर बनाएं"

  • अतिरिक्त कोडबेस कॉन्टेक्स्ट: Assistant की तर्क क्षमता में, अपने ऐप्लिकेशन लॉजिक और कस्टम आर्किटेक्चर को रजिस्टर करें.

    • Linux / macOS: bash ./update.sh agy --context_dir /path/to/your/codebase # Or for Claude Code: ./update.sh claude --context_dir /path/to/your/codebase
    • Windows (PowerShell): powershell .\update.ps1 -Type agy -ContextDir C:\path\to\your\codebase

Claude Code के स्लैश कमांड का रेफ़रंस

Claude Code का इस्तेमाल करते समय, बिल्ट-इन ये स्लैश कमांड उपलब्ध होते हैं. Google Antigravity में, इन केपबिलिटी को नैचुरल लैंग्वेज प्रॉम्प्ट या स्किल टूल के नामों का इस्तेमाल करके शुरू किया जा सकता है. जैसे, validate_gaql और inspect_object. इनके बारे में, मुख्य सुविधाएं सेक्शन में बताया गया है:

स्लैश कमांड मकसद उदाहरण
/validate-gaql GAQL सिंटैक्स, कंपैटिबिलिटी, और नियमों की पुष्टि करता है. /validate-gaql
/inspect-object Protobuf फ़ील्ड, टाइप, और enum की जांच करता है. /inspect-object Campaign
/get-cids एमसीसी की हैरारकी और क्लाइंट सीआईडी को हल करता है. /get-cids 1234567890
/troubleshoot-conversions ऑफ़लाइन कन्वर्ज़न अपलोड करने की समस्या को डाइग्नोस्टिक्स की मदद से हल करता है. /troubleshoot-conversions
/pmax-filter परफ़ॉर्मेंस मैक्स के लिस्टिंग फ़िल्टर और एक्सक्लूज़न जनरेट करता है. /pmax-filter
/explain चार हिस्सों में स्ट्रक्चर्ड जानकारी देता है. /explain shared set
/step-by-step कई चरणों वाले टास्क के एक्ज़ीक्यूशन प्लान को फ़ॉर्म्युलेट करता है. /step-by-step upload conversions
/assistant-tutorial 11 चरणों वाला इंटरैक्टिव वॉकथ्रू चलाता है. /assistant-tutorial

मेंटेनेंस और अपडेट

डेटाबेस, प्लग इन इंस्टॉलेशन, और क्लाइंट लाइब्रेरी को अपडेट करने के लिए:

Antigravity

Linux / macOS: bash ./update.sh agy # Update Antigravity plugin ./update.sh agy --all # Include all client libraries

Windows (PowerShell): powershell .\update.ps1 -Type agy .\update.ps1 -Type agy -All

Claude Code

Linux / macOS: bash ./update.sh claude # Update Claude Code plugin ./update.sh claude --all # Include all client libraries

Windows (PowerShell): powershell .\update.ps1 -Type claude .\update.ps1 -Type claude -All

अनइंस्टॉल करना

Assistant प्लग इन को अनइंस्टॉल करने के लिए:

Antigravity

Linux / macOS: bash rm -rf ~/.gemini/config/plugins/google-ads-api-developer-assistant

Windows (PowerShell): powershell Remove-Item -Recurse -Force "$HOME\.gemini\config\plugins\google-ads-api-developer-assistant"

इसके बाद, Antigravity होस्ट सेशन रीस्टार्ट करें.

Claude Code

Claude Code के चालू सेशन में: none /plugin uninstall google-ads-api-developer-assistant@google-ads-assistant-local

इसके अलावा, अपने टर्मिनल से: bash claude plugin uninstall google-ads-api-developer-assistant@google-ads-assistant-local

(ज़रूरी नहीं) लोकल Marketplace रजिस्ट्री हटाएं: bash claude plugin marketplace remove google-ads-assistant-local

समुदाय और सहायता

योगदान से जुड़े दिशा-निर्देश

योगदान का स्वागत है! दिशा-निर्देशों के लिए, GitHub डेटाबेस में मौजूद CONTRIBUTING.md फ़ाइल देखें.

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