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 शेल इंटिग्रेशन चालू किया है, तो इस डायरेक्ट्री में जाने पर, असिस्टेंट सेशन अपने-आप शुरू हो जाएगा).

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