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

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

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

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

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

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

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

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

   • GitHub से google-ads-api-developer-assistant के डेटा स्टोर करने की जगह का स्थानीय क्लोन.

शुरू करें

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

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

   (ध्यान दें: अगर आपने Antigravity शेल इंटिग्रेशन की सुविधा चालू की है, तो इस डायरेक्ट्री में जाने पर, Assistant का सेशन अपने-आप शुरू हो जाएगा).

2. इंस्टॉल करने वाली स्क्रिप्ट चलाएं: यह स्क्रिप्ट, डेवलपमेंट एनवायरमेंट को शुरू करती है और ज़रूरी Google Ads क्लाइंट लाइब्रेरी को क्लोन करती है. Python डिफ़ॉल्ट रूप से इंस्टॉल होती है.

   ./install.sh
   

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

3. क्रेडेंशियल कॉन्फ़िगर करें: पक्का करें कि आपकी google-ads.yaml (या भाषा के हिसाब से इसके बराबर की फ़ाइल) आपकी होम डायरेक्ट्री में मौजूद हो.

4. Assistant के साथ इंटरैक्ट करें: सेशन चालू होने के बाद, टर्मिनल में सीधे तौर पर नैचुरल लैंग्वेज का इस्तेमाल करके, Assistant के साथ इंटरैक्ट किया जा सकता है.

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

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

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

• कोड जनरेट करना: GAQL क्वेरी और Python के कोड स्निपेट जनरेट करें, जिन्हें चलाया जा सकता है.

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

• एपीआई को सीधे तौर पर चलाना: जनरेट की गई, सिर्फ़ पढ़ने की अनुमति वाली Python स्क्रिप्ट को, अलग किए गए वर्चुअल एनवायरमेंट (.venv) में सीधे तौर पर चलाएं. साथ ही, टर्मिनल में फ़ॉर्मैट किए गए नतीजों को टेबल के तौर पर देखें.

  • Assistant से सिर्फ़ यह कहें: "कोड चलाएं" या "स्क्रिप्ट चलाएं".
  • सुरक्षा के लिए, बदलाव करने वाले ऑपरेशन (बनाना, अपडेट करना, मिटाना) जनरेट किए जाते हैं, लेकिन उन्हें कभी नहीं चलाया जाता.

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

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

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

  • "मुझे अपनी क्वेरी के लिए कोई नतीजा क्यों नहीं दिख रहा है?"
  • "ग्राहक 123-456-7890 के लिए, मेरे कन्वर्ज़न से जुड़ी समस्या हल करें." (इससे saved/data/ में, गड़बड़ी की जानकारी वाली विस्तृत रिपोर्ट जनरेट होती है).

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

  • अपने प्रोजेक्ट की फ़ाइलें रजिस्टर करने के लिए, --context_path विकल्प के साथ update.sh स्क्रिप्ट का इस्तेमाल करें: none ./update.sh --context_path /path/to/your/codebase
  • इससे Assistant, आपकी पसंदीदा भाषा में जवाब बनाते या कोड जनरेट करते समय, आपकी ऐप्लिकेशन लॉजिक को अपनी वजह में शामिल कर पाती है.

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

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

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

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

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

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