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: ```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. प्लगिन चालू करना

  • ऐंटीग्रैविटी: प्लगिन लोड करने के लिए, ऐंटीग्रैविटी / agy होस्ट सेशन को रीस्टार्ट करें.
  • Claude Code: Claude Code के चालू सेशन में, /reload-plugins चलाएं या claude फिर से शुरू करें.

5. Assistant से बातचीत करना

Assistant से बातचीत करने के लिए, टर्मिनल में सीधे तौर पर नेचुरल लैंग्वेज प्रॉम्प्ट या स्लैश कमांड का इस्तेमाल किया जा सकता है.

मुख्य सुविधाएं

  • नैचुरल लैंग्वेज में सवाल-जवाब: Google Ads API की सुविधाओं, सबसे सही तरीकों या खास संसाधनों के बारे में सवाल पूछें.

  • नैचुरल लैंग्वेज में सवाल-जवाब का सेशन और कॉन्सेप्ट से जुड़ी सलाह: 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 के लिए, पिछले महीने के हिसाब से सबसे ज़्यादा लागत वाले पांच कीवर्ड दिखाओ."
    • "नतीजों को 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

(ज़रूरी नहीं) लोकल मार्केटप्लेस रजिस्ट्री को हटाएं: bash claude plugin marketplace remove google-ads-assistant-local

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

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

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

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