تثبيت

سواء كنت تثبِّت المكتبة من 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 git@github.com:googleads/google-ads-python.git
   

3. إدخال المستودع وتثبيته:

   cd google-ads-python
   python -m pip install .
   

4. إذا كنت تنوي تطوير المكتبة، أجرِ اختبارات الوحدة قبل إجراء أي تغييرات وبعده:

   1. تأكد من توفر جميع الإصدارات المعتمدة من لغة بايثون في بيئتك. باستخدام 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