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 Developer Assistant क्या है? लेख पढ़ें.

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

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

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

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

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

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

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

  • "कौनसे कैंपेन टाइप उपलब्ध हैं?"
  • "मैं 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 के लिए, पिछले महीने की लागत के हिसाब से टॉप पांच कीवर्ड दिखाओ."
  • "नतीजों को CSV फ़ाइल के तौर पर सेव करें." (saved/csv/ में एक्सपोर्ट किया जाता है).

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

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

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

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

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

  • Claude Code: /get-cids <manager_cid>
  • नैचुरल लैंग्वेज: "Get all client customer IDs under manager 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. इनके बारे में मुख्य सुविधाएं में बताया गया है:

रखरखाव और अपडेट

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

./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 फ़ाइल देखें.

अगले चरण

• Google Ads API एजेंट की स्किल इंस्टॉल करना
• अपने एआई क्लाइंट को Google Ads के एमसीपी सर्वर से कनेक्ट करना
• जानें कि Google Ads API Developer Assistant कैसे काम करता है