سواء كنت تثبِّت المكتبة من PYPI أو تستنسخها من GitHub، نقترح عليك تنفيذ الخطوات التالية باستخدام بيئة افتراضية نشطة. للحصول على معلومات حول كيفية إنشاء بيئة افتراضية وتفعيلها، راجع وثائق البيئة الافتراضية.
تثبيت الوحدة من PyPI
ويتم توزيع المكتبة على PyPI ويمكن تثبيتها بسهولة باستخدام pip. ما عليك سوى تشغيل الأمر التالي:
python -m pip install google-ads
تثبيت المكتبة من GitHub
يمكن نسخ رمز المصدر للمكتبة من GitHub إلى جهازك المحلي. من المفيد نسخ رمز المصدر من أجل تنفيذ الأمثلة بسهولة أو تطوير المكتبة نفسها. كمرجع، تشغيل أحد أمثلة المصادقة خطوة مطلوبة في تهيئة المكتبة للاستخدام.
تأكَّد من توفُّر
python3.6
أو أكثر في بيئتك. إن أبسط طريقة هي استخدامpyenv
:pyenv global 3.6
نسخ مكتبة العميل من GitHub:
git clone git@github.com:googleads/google-ads-python.git
إدخال المستودع وتثبيته:
cd google-ads-python
python -m pip install .
إذا كنت تنوي تطوير المكتبة، فشغّل اختبارات الوحدة قبل إجراء أي تغييرات وبعدها:
تأكد من توفر كل من
python3.6
وpython3.7
في بيئتك. استخدامpyenv
، كما ذكرنا أعلاه:pyenv global 3.6 3.7
إجراء اختبارات الوحدة للتأكد من عمل المكتبة بشكل صحيح:
nox