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 का ऐक्सेस:

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

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

   • Python 3.10 या इससे नया वर्शन इंस्टॉल हो और आपके सिस्टम पाथ पर मौजूद हो. जनरेट किए गए कोड को चलाने और लोकल वैलिडेशन साइडकार को रन करने के लिए, Python का इस्तेमाल किया जाता है.
   • होस्ट एजेंट प्लैटफ़ॉर्म:
     • Google Antigravity का कमांड-लाइन टूल (agy) या
     • Claude Code का कमांड-लाइन टूल (claude Node.js 18+ के साथ).
   • 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) को शामिल करने का विकल्प होता है.

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

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

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

.\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, जवाबों के लिए सिर्फ़ LLM की सामान्य ट्रेनिंग पर निर्भर रहने के बजाय, एपीआई की आधिकारिक परिभाषाओं का इस्तेमाल करता है.

  • "कैंपेन के कौन-कौनसे टाइप उपलब्ध हैं?"
  • "मैं 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:

    ./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. इनके बारे में, मुख्य सुविधाएं में बताया गया है:

देखभाल और अपडेट

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

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

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

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

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

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

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

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

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

/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 पर समस्याएं: रिपॉज़िटरी में मौजूद 'समस्याएं' टैब पर जाकर, गड़बड़ियों की शिकायत करें, सुविधाओं के बारे में सुझाव दें या मदद के लिए अनुरोध करें.
• Discord: Google की विज्ञापन और मेज़रमेंट कम्यूनिटी के Discord सर्वर पर, #ads-api-ai-tools चैनल में शामिल होकर चर्चा करें.
• सुझाव, शिकायत या राय: इस सर्वे फ़ॉर्म के ज़रिए, अपने सुझाव, शिकायत या राय शेयर करें.

योगदान देने के दिशा-निर्देश

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