التثبيت

سواء كنت تثبّت المكتبة من 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