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

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

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

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

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

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

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

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

./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 दिनों में सबसे ज़्यादा कन्वर्ज़न वाले कैंपेन दिखाओ."
    • "ग्राहक 123-456-7890 के लिए, चालू किए गए सभी विज्ञापन ग्रुप के नाम दिखाओ."
    • "परफ़ॉर्मेंस मैक्स कैंपेन बनाने के लिए कोड लिखो." जनरेट किया गया कोड, saved/code/ डायरेक्ट्री में सेव किया जाता है.

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

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

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

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

      ./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

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

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

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 डेवलपर असिस्टेंट क्या है?