התקנה

בין אם אתם מתקינים את הספרייה מ-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. מוודאים שכל הגרסאות הנתמכות של שפת Python זמינות ב- בסביבה שלך. באמצעות 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