התקנה

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