التثبيت

سواء كنت تثبّت المكتبة من 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 (الإصدارات من 3.9 إلى 3.14، ويُنصح باستخدام الإصدار 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