התקנה

לא משנה אם אתם מתקינים את הספרייה מ-PyPI או משכפלים אותה מ-GitHub, בצעו את השלבים הבאים באמצעות סביבה וירטואלית פעילה. במאמרי העזרה בנושא סביבה וירטואלית מוסבר איך ליצור ולהפעיל סביבה וירטואלית.

כדי ליצור ולהפעיל במהירות סביבה וירטואלית:

python3 -m venv env
source env/bin/activate

התקנת המודול מ-PyPI

הספרייה מופצת ב-PyPI ואפשר להתקין אותה באמצעות pip עם הפקודה הבאה:

python -m pip install google-ads

אימות התקנה

מוודאים שהמודול הותקן בצורה נכונה:

python -c "import google.ads.googleads"

התקנת הספרייה מ-GitHub

אפשר לשכפל את קוד המקור של הספרייה מ-GitHub למחשב המקומי. שיבוט קוד המקור שימושי להרצת הדוגמאות או לפיתוח הספרייה עצמה. לידיעתכם, הרצת אחת מהדוגמאות לאימות היא שלב חובה בהגדרת הספרייה לשימוש.

1. מוודאים שבסביבה שלכם מותקנת גרסה נתמכת של Python (גרסה 3.9 עד 3.14, מומלץ גרסה 3.11 ואילך). הדרך הכי פשוטה היא להשתמש ב-pyenv:

   pyenv install 3.13
   pyenv local 3.13

2. משכפלים את ספריית הלקוח מ-GitHub:

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

3. נכנסים למאגר ומתקינים אותו במצב שניתן לעריכה:

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

4. אם אתם מתכוונים לפתח את הספרייה, הריצו את בדיקות היחידה לפני ואחרי ביצוע שינויים:

   1. מוודאים שכל הגרסאות הנתמכות של שפת Python זמינות בסביבה שלכם באמצעות pyenv:

      pyenv local 3.9 3.10 3.11 3.12 3.13 3.14

   2. מתקינים את יחסי התלות של הספרייה שספציפיים לבדיקה:

      python -m pip install -e ".[tests]"

   3. מריצים את בדיקות היחידה כדי לוודא שהספרייה פועלת כמו שצריך:

      nox

   4. אופציונלי: אפשר גם להריץ את בדיקות היחידה באמצעות Docker. קודם כל, מוודאים ש-Docker מותקן. לאחר מכן, מריצים את הפקודות הבאות מהספרייה google-ads-python:

      docker build -t google-ads-python:test .
      docker run -it google-ads-python:test nox