تثبيت

سواء كنت تثبِّت المكتبة من PYPI أو تستنسخها من GitHub، نقترح عليك تنفيذ الخطوات التالية باستخدام بيئة افتراضية نشطة. للحصول على معلومات حول كيفية إنشاء بيئة افتراضية وتفعيلها، راجع وثائق البيئة الافتراضية.

تثبيت الوحدة من PyPI

ويتم توزيع المكتبة على PyPI ويمكن تثبيتها بسهولة باستخدام pip. ما عليك سوى تشغيل الأمر التالي:

python -m pip install google-ads

تثبيت المكتبة من GitHub

يمكن نسخ رمز المصدر للمكتبة من GitHub إلى جهازك المحلي. من المفيد نسخ رمز المصدر من أجل تنفيذ الأمثلة بسهولة أو تطوير المكتبة نفسها. كمرجع، تشغيل أحد أمثلة المصادقة خطوة مطلوبة في تهيئة المكتبة للاستخدام.

1. تأكَّد من توفُّر python3.6 أو أكثر في بيئتك. إن أبسط طريقة هي استخدام pyenv:

   pyenv global 3.6
   

2. نسخ مكتبة العميل من GitHub:

   git clone git@github.com:googleads/google-ads-python.git
   

3. إدخال المستودع وتثبيته:

   cd google-ads-python
   python -m pip install .
   

4. إذا كنت تنوي تطوير المكتبة، فشغّل اختبارات الوحدة قبل إجراء أي تغييرات وبعدها:

   1. تأكد من توفر كل من python3.6 وpython3.7 في بيئتك. استخدام pyenv، كما ذكرنا أعلاه:

      pyenv global 3.6 3.7
      

   2. إجراء اختبارات الوحدة للتأكد من عمل المكتبة بشكل صحيح:

      nox