इंस्टॉलेशन

लाइब्रेरी को 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