وسواء كنت تثبِّت المكتبة من خلال PyPI أو تنسخها من GitHub، ننصحك بتنفيذ الخطوات التالية باستخدام شبكة افتراضية نشطة محددة. للحصول على معلومات حول كيفية إنشاء بطاقة افتراضية وتفعيلها يمكنك الاطّلاع على مستندات البيئة الافتراضية.
تثبيت الوحدة من PyPI
يتم توزيع المكتبة على PyPI ويمكنها أن يتم تثبيتها باستخدام pip الأمر التالي:
python -m pip install google-ads
تثبيت المكتبة من GitHub
يمكن استنساخ رمز المصدر للمكتبة من GitHub. على جهازك المحلي. ومن المفيد استنساخ رمز المصدر لتسهيل عملية لتنفيذ الأمثلة أو تطوير المكتبة نفسها. كمرجع لك، يعمل فأحد أمثلة المصادقة هو خطوة مطلوبة في تهيئة المكتبة للاستخدام.
يُرجى التأكُّد من توفُّر الإصدار
python3.8
أو إصدار أحدث في بيئتك. أبسط طريقة هي استخدامpyenv
:pyenv local 3.8
استنساخ مكتبة العملاء من GitHub:
git clone git@github.com:googleads/google-ads-python.git
أدخِل المستودع وثبِّته:
cd google-ads-python python -m pip install .
إذا كنت تريد تطوير المكتبة، عليك إجراء اختبارات الوحدات قبل وبعد إجراء أي تغييرات:
التأكد من أن جميع الإصدارات المعتمدة للغة بايثون متوفرة في بيئتك. استخدام
pyenv
::pyenv local 3.8 3.9 3.10 3.11 3.12
تثبيت ملحقات المكتبة الخاصة بالاختبار:
python -m pip install .[tests]
يمكنك إجراء اختبارات الوحدة للتأكّد من أن المكتبة تعمل بشكل صحيح:
nox
اختياري: يمكن أيضًا إجراء اختبارات الوحدات باستخدام Docker. أولاً، يجب عليك تثبيت Docker. ثم، من الدليل
google-ads-python
، شغِّل ما يلي:docker build -t google-ads-python:test . docker run -it google-ads-python:test nox