इंस्टॉल करना

चाहे आपको 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 [e-mail]: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