تثبيت

سواء كنت تثبّت المكتبة من 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. تأكَّد من توفُّر جميع الإصدارات المتوافقة من لغة 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