התקנה

בין אם מתקינים את הספרייה מ-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