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

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

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

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

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

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

    • एक Google Ads API डेवलपर टोकन.
    • एक Google Ads कॉन्फ़िगरेशन फ़ाइल. इसे आपके डेवलपर टोकन, OAuth 2.0 क्रेडेंशियल, और ग्राहक आईडी के साथ कॉन्फ़िगर किया गया हो. यह आपकी होम डायरेक्ट्री में मौजूद होनी चाहिए (जैसे, Python के लिए google-ads.yaml). क्लाइंट लाइब्रेरी की कॉन्फ़िगरेशन गाइड देखें .
    • 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 की सुविधाओं, आर्किटेक्चर के नियमों या खास संसाधनों के बारे में सवाल पूछें. 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 डेवलपर असिस्टेंट क्या है?