ইনস্টল করা

আপনি 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. pyenv ব্যবহার করে আপনার এনভায়রনমেন্টে Python ভাষার সবকটি কাজ করে এমন ভার্সন উপলভ্য আছে কিনা তা নিশ্চিত করুন:

      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