تثبيت

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