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

ध्यान दें: यह टूल, ओपन-सोर्स प्रोजेक्ट है. यह Google का आधिकारिक प्रॉडक्ट नहीं है.

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

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

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

   • Google Ads API डेवलपर टोकन.
   • Google Ads कॉन्फ़िगरेशन फ़ाइल. यह फ़ाइल, आपके डेवलपर टोकन, 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 को Assistant के GEMINI.mdकॉन्टेक्स्ट फ़ाइलों और ज़रूरी टूल का इस्तेमाल करने के लिए कॉन्फ़िगर करती है.

   ./install.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 डालें. अगर आपकी डिफ़ॉल्ट भाषा Python, Ruby या PHP है, तो स्क्रिप्ट Assistant के कॉन्टेक्स्ट में एक्ज़ीक्यूट होगी. सुरक्षा नीतियों की वजह से, कंपाइल की गई भाषाएं काम नहीं करेंगी.

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

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

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

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

• ज़्यादा जानकारी: संदर्भ के लिए अपना कोडबेस जोड़ें.

  • v2.3.0 से, अपने प्रोजेक्ट फ़ाइलों को शामिल करने के लिए context_dir फ़्लैग का इस्तेमाल करें: ./update.sh --context_dir /path/to/your/codebase इससे Assistant को जवाब बनाते समय, अपने तर्क में आपके ऐप्लिकेशन लॉजिक को शामिल करने की अनुमति मिलती है.
  • इस सुविधा की मदद से, Assistant सेव किए गए कोड के उदाहरणों को आपकी चुनी हुई भाषा में दिखा सकती है. इससे आधिकारिक क्लाइंट लाइब्रेरी उपलब्ध न होने पर भी सहायता मिलती है.
  • कोड का आउटपुट पाने का अनुरोध करने से पहले, Assistant को यह बताएं: write saved code examples in <language of your application>

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

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

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

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

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

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