التثبيت

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