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

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

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

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

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

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

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

    • Python 3.10 या इसके बाद का वर्शन इंस्टॉल किया गया हो और आपके सिस्टम के PATH में मौजूद हो. Python का इस्तेमाल, जनरेट किए गए कोड को चलाने और लोकल वैलिडेशन साइडकार को चलाने के लिए किया जाता है.
    • होस्ट एजेंट प्लैटफ़ॉर्म:
    • आपके सिस्टम PATH पर 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:

./install.sh agy
# Or include additional client libraries:
./install.sh agy --java --dotnet

Windows (PowerShell):

.\install.ps1 -Type agy
# Or include additional client libraries:
.\install.ps1 -Type agy -Java -Dotnet

Claude Code

Linux / macOS:

./install.sh claude
# Or include additional client libraries:
./install.sh claude --php --dotnet

Windows (PowerShell):

.\install.ps1 -Type claude
# Or include additional client libraries:
.\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 दिनों में सबसे ज़्यादा कन्वर्ज़न वाले कैंपेन दिखाओ."
    • "Get all enabled ad group names for customer 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 के लिए, पिछले महीने की लागत के हिसाब से टॉप पांच कीवर्ड दिखाओ."
    • "नतीजों को CSV फ़ाइल के तौर पर सेव करें." (saved/csv/ में एक्सपोर्ट किया जाता है).

  • एपीआई को सीधे तौर पर लागू करना और म्यूटेट सुरक्षा: जनरेट की गई रीड-ओनली स्क्रिप्ट को सीधे तौर पर मैनेज किए जा रहे वर्चुअल एनवायरमेंट में लागू करें.

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

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

    • Claude Code: /troubleshoot-conversions
    • नैचुरल लैंग्वेज: "ग्राहक 123-456-7890 के लिए कन्वर्ज़न से जुड़ी समस्या हल करो." (रिपोर्ट saved/data/ में सेव की गई हैं).

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

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

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

    • Claude Code: /pmax-filter
    • नैचुरल लैंग्वेज: "मेरे परफ़ॉर्मेंस मैक्स कैंपेन के लिए, वेबपेज को बाहर रखने वाले फ़िल्टर बनाएं"

  • कोड बेस के बारे में ज़्यादा जानकारी: अपने ऐप्लिकेशन के लॉजिक और कस्टम आर्किटेक्चर को असिस्टेंट के रीज़निंग में रजिस्टर करें.

    • Linux / macOS:

      ./update.sh agy --context_dir /path/to/your/codebase
# Or for Claude Code:
./update.sh claude --context_dir /path/to/your/codebase

    • Windows (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:

./update.sh agy          # Update Antigravity plugin
./update.sh agy --all    # Include all client libraries

Windows (PowerShell):

.\update.ps1 -Type agy
.\update.ps1 -Type agy -All

Claude Code

Linux / macOS:

./update.sh claude       # Update Claude Code plugin
./update.sh claude --all # Include all client libraries

Windows (PowerShell):

.\update.ps1 -Type claude
.\update.ps1 -Type claude -All

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

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

Antigravity

Linux / macOS:

rm -rf ~/.gemini/config/plugins/google-ads-api-developer-assistant

Windows (PowerShell):

Remove-Item -Recurse -Force `
  "$HOME\.gemini\config\plugins\google-ads-api-developer-assistant"

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

Claude Code

Claude Code के किसी चालू सेशन में:

/plugin uninstall google-ads-api-developer-assistant@google-ads-assistant-local

या अपने टर्मिनल से:

claude plugin uninstall \
  google-ads-api-developer-assistant@google-ads-assistant-local

(ज़रूरी नहीं) लोकल मार्केटप्लेस रजिस्ट्री को हटाएं:

claude plugin marketplace remove google-ads-assistant-local

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

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

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

अगले चरण

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