Google Ads API डेवलपर असिस्टेंट

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

फ़ायदे

  • प्रोडक्टिविटी बढ़ाएं: दस्तावेज़ खोजने और बॉयलरप्लेट कोड लिखने में कम समय लगाएं.
  • मुश्किल कामों को आसान बनाएं: सामान्य अंग्रेज़ी में दिए गए प्रॉम्प्ट से, Google Ads Query Language (GAQL) और क्लाइंट लाइब्रेरी कोड जनरेट करें.
  • एपीआई के बारे में जानें: एपीआई के कॉन्सेप्ट समझें. साथ ही, यह देखें कि आम बोलचाल की भाषा में किए गए अनुरोधों को लागू किए जा सकने वाले कोड में कैसे बदला जाता है.
  • इंटरैक्टिव डीबगिंग: गड़बड़ियों को समझने और उन्हें ठीक करने के लिए सिलसिलेवार तरीके से निर्देश पाएं.
  • बेहतर वर्कफ़्लो: डेवलपमेंट और टेस्टिंग लूप को कमांड लाइन में रखें.

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

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

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

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

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

    • Python 3.10 या इसके बाद का वर्शन. Python डिफ़ॉल्ट भाषा है. इसलिए, आपके पास यह इंस्टॉल होनी चाहिए और आपके पाथ पर होनी चाहिए.
    • Gemini CLI इंस्टॉल हो.
    • jq (कमांड-लाइन JSON प्रोसेसर). अगर यह मौजूद नहीं है, तो सेटअप स्क्रिप्ट इसे इंस्टॉल करने की कोशिश करेगी.

  3. डेटा स्टोर करने की जगह:

    • GitHub से google-ads-api-developer-assistant रिपॉज़िटरी का लोकल क्लोन:

अपनी प्रोफ़ाइल बनाना शुरू करें

  1. प्रोजेक्ट डायरेक्ट्री पर जाएं:

    cd <full path>/google-ads-api-developer-assistant

  2. सेटअप स्क्रिप्ट चलाएं: यह स्क्रिप्ट, Gemini CLI को कॉन्फ़िगर करती है, ताकि वह असिस्टेंट के GEMINI.md कॉन्टेक्स्ट फ़ाइलों और ज़रूरी टूल का इस्तेमाल कर सके.

    ./setup.sh

    अगर Windows का इस्तेमाल किया जा रहा है, तो setup.ps1 PowerShell स्क्रिप्ट चलाएं.

  3. Gemini CLI शुरू करने के लिए:

    gemini

  4. Assistant से इंटरैक्ट करना: अब आम बोलचाल की भाषा में सवाल पूछे जा सकते हैं या निर्देश दिए जा सकते हैं.

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

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

    • "कौनसे कैंपेन टाइप उपलब्ध हैं?"
    • "GAQL में तारीख के हिसाब से फ़िल्टर कैसे किया जाता है?"
    • "click_view और impression_view के बीच का अंतर बताओ."

  • कोड जनरेट करना: GAQL क्वेरी और एक्ज़ीक्यूटेबल Python कोड स्निपेट जनरेट करना.

    • "मुझे ऐसे कैंपेन दिखाओ जिनमें पिछले 30 दिनों में सबसे ज़्यादा कन्वर्ज़न हुए हैं."
    • "कैंपेन आईडी 12345 के लिए, चालू किए गए सभी विज्ञापन ग्रुप के नाम दिखाओ."
    • "सभी कैंपेन में अस्वीकार किए गए विज्ञापनों का पता लगाएं." जनरेट किया गया कोड, saved_code/ डायरेक्ट्री में सेव किया जाता है.

  • एपीआई को सीधे तौर पर इस्तेमाल करना: Gemini CLI से, सिर्फ़ पढ़ने के लिए जनरेट की गई Python स्क्रिप्ट को सीधे तौर पर चलाएं और अपने टर्मिनल में फ़ॉर्मैट किए गए नतीजे देखें. Assistant के कोड जनरेट करने के बाद, आपको स्क्रीन पर यह प्रॉम्प्ट दिखेगा:

To run this script, you will need to replace YOUR_CUSTOMER_ID with your actual
Google Ads customer ID and execute the following command in
your shell: <command>

run डालें. इससे स्क्रिप्ट, Assistant के कॉन्टेक्स्ट में काम करेगी.

  • CSV फ़ाइल में एक्सपोर्ट करना: एपीआई कॉल से मिले टेबल वाले नतीजों को CSV फ़ाइल में सेव करें.

    • "नतीजों को CSV फ़ाइल में सेव करो." फ़ाइलें, saved_csv/ डायरेक्ट्री में सेव की जाती हैं.

  • समस्या हल करने में सहायता: गड़बड़ी के मैसेज या एपीआई के अनचाहे व्यवहार से जुड़ी मदद पाएं.

    • "मुझे 'AuthenticationError.OAUTH_TOKEN_INVALID' गड़बड़ी का मैसेज मिला है. मुझे क्या करना चाहिए?"
    • "मुझे अपनी क्वेरी के लिए कोई नतीजा क्यों नहीं दिख रहा है?"

इस्तेमाल के उदाहरण

  • रिपोर्टिंग:
    • "मुझे ग्राहक 12345678 के लिए, पिछले महीने के सबसे ज़्यादा लागत वाले पांच कीवर्ड दिखाओ."
  • खाते का स्ट्रक्चर:
    • "सभी कैंपेन के नाम और उनके आईडी दिखाओ."
  • समस्या हल करना:
    • "मैंने 100 कन्वर्ज़न अपलोड किए हैं, लेकिन यूज़र इंटरफ़ेस (यूआई) में सिर्फ़ 78 दिख रहे हैं. मैं एपीआई का इस्तेमाल करके, इस समस्या को कैसे ठीक करूं?"
  • सीखना:
    • "मुझे एपीआई का इस्तेमाल करके, परफ़ॉर्मेंस मैक्स कैंपेन बनाने का तरीका बताओ."

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

  • GitHub की समस्याएं: गड़बड़ियों की शिकायत करें, सुविधाओं के बारे में सुझाव दें या रिपॉज़िटरी में मौजूद समस्याएं टैब में जाकर सहायता पाएं.
  • Discord: Google Advertising and Measurement Community Discord सर्वर पर मौजूद #ads-api-ai-tools चैनल में शामिल होकर चर्चा में हिस्सा लें.
  • सुझाव/राय दें या शिकायत करें: इस सर्वे फ़ॉर्म के ज़रिए अपने सुझाव/राय दें या शिकायत करें.

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

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