इंस्टॉल करना

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

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

लाइब्रेरी PyPI पर वितरित की गई है और यह कर सकती है: पीआईपी का इस्तेमाल करके, निम्न आदेश:

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