इंस्टॉल करना

चाहे 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