इंस्टॉलेशन

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

वर्चुअल एनवायरमेंट को तुरंत बनाने और चालू करने के लिए:

python3 -m venv env
source env/bin/activate

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

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

python -m pip install google-ads

इंस्टॉल हो जाने की पुष्टि करें

पुष्टि करें कि मॉड्यूल सही तरीके से इंस्टॉल किया गया है:

python -c "import google.ads.googleads"

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

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

1. पक्का करें कि आपके एनवायरमेंट में Python का कोई ऐसा वर्शन मौजूद हो जो काम करता हो. जैसे, Python 3.9 से 3.14 तक. हमारा सुझाव है कि आप Python 3.11 या इसके बाद का वर्शन इस्तेमाल करें. सबसे आसान तरीका है, pyenv का इस्तेमाल करना:

   pyenv install 3.13
   pyenv local 3.13

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

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

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

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

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

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

      pyenv local 3.9 3.10 3.11 3.12 3.13 3.14

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

      python -m pip install -e ".[tests]"

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

      nox

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

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