इंस्टॉल करना

हमारा सुझाव है कि PyPI से लाइब्रेरी इंस्टॉल करने या GitHub से उसे क्लोन करने के लिए, किसी चालू वर्चुअल एनवायरमेंट का इस्तेमाल करके नीचे दिया गया तरीका अपनाएं. वर्चुअल एनवायरमेंट बनाने और चालू करने के तरीके के बारे में जानने के लिए, वर्चुअल एनवायरमेंट से जुड़ा दस्तावेज़ देखें.

PyPI से मॉड्यूल इंस्टॉल करना

लाइब्रेरी को PyPI पर उपलब्ध कराया जाता है. इसे pip का इस्तेमाल करके, इस कमांड के साथ इंस्टॉल किया जा सकता है:

python -m pip install google-ads

GitHub से लाइब्रेरी इंस्टॉल करना

लाइब्रेरी के सोर्स कोड को GitHub से अपनी लोकल मशीन पर क्लोन किया जा सकता है. उदाहरणों को आसानी से लागू करने या लाइब्रेरी को खुद डेवलप करने के लिए, सोर्स कोड को क्लोन करना मददगार होता है. उदाहरण के लिए, पुष्टि करने के किसी एक उदाहरण को चलाना, लाइब्रेरी को इस्तेमाल करने के लिए कॉन्फ़िगर करने का ज़रूरी चरण है.

1. पक्का करें कि आपके एनवायरमेंट में python3.8 या उसके बाद का वर्शन मौजूद हो. pyenv का इस्तेमाल करना सबसे आसान तरीका है:

   pyenv local 3.8

2. GitHub से क्लाइंट लाइब्रेरी को क्लोन करें:

   git clone git@github.com:googleads/google-ads-python.git

3. रिपॉज़िटरी डालें और उसे इंस्टॉल करें:

   cd google-ads-python
   python -m pip install .

4. अगर आपको लाइब्रेरी डेवलप करनी है, तो कोई भी बदलाव करने से पहले और बाद में यूनिट टेस्ट चलाएं:

   1. पक्का करें कि आपके एनवायरमेंट में, Python भाषा के सभी वर्शन उपलब्ध हों. pyenv का इस्तेमाल करके:

      pyenv local 3.8 3.9 3.10 3.11 3.12

   2. लाइब्रेरी की टेस्ट-स्पेसिफ़िक डिपेंडेंसी इंस्टॉल करें:

      python -m pip install .[tests]

   3. लाइब्रेरी सही तरीके से काम कर रही है, यह पक्का करने के लिए यूनिट टेस्ट चलाएं:

      nox

   4. ज़रूरी नहीं: यूनिट टेस्ट, Docker का इस्तेमाल करके भी चलाए जा सकते हैं. सबसे पहले, आपके पास Docker इंस्टॉल होना चाहिए. इसके बाद, google-ads-python डायरेक्ट्री से यह कमांड चलाएं:

      docker build -t google-ads-python:test .
      docker run -it google-ads-python:test nox