התקנה
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בין אם אתם מתקינים את הספרייה מ-PyPI או משכפלים אותה מ-GitHub, מומלץ לבצע את השלבים הבאים באמצעות סביבה וירטואלית פעילה. מידע על יצירה והפעלה של סביבה וירטואלית זמין במאמר בנושא סביבה וירטואלית.
התקנת המודול מ-PyPI
הספרייה מופצת ב-PyPI ואפשר להתקין אותה באמצעות pip עם הפקודה הבאה:
python -m pip install google-ads
התקנת הספרייה מ-GitHub
אפשר לשכפל את קוד המקור של הספרייה מ-GitHub למחשב המקומי. מומלץ לשכפל את קוד המקור כדי להריץ בקלות את הדוגמאות או לפתח את הספרייה עצמה. לצורך העיון, הפעלת אחד מהדוגמאות לאימות היא שלב חובה בהגדרת הספרייה לשימוש.
מוודאים שגרסה python3.8 ואילך קיימת בסביבה שלכם.
הדרך הפשוטה ביותר היא באמצעות pyenv:
pyenv local 3.8
משכפלים את ספריית הלקוח מ-GitHub:
git clone git@github.com:googleads/google-ads-python.git
מזינים את המאגר ומתקינים אותו:
cd google-ads-python
python -m pip install .
אם אתם מתכוונים לפתח את הספרייה, כדאי להריץ את בדיקות היחידה לפני ואחרי ביצוע שינויים:
מוודאים שכל הגרסאות הנתמכות של שפת Python זמינות בסביבה שלכם. שימוש ב-pyenv::
pyenv local 3.8 3.9 3.10 3.11 3.12
מתקינים את יחסי התלות הספציפיים של הבדיקה בספרייה:
python -m pip install .[tests]
מריצים את בדיקות היחידה כדי לוודא שהספרייה פועלת כמו שצריך:
nox
אופציונלי: אפשר להריץ את בדיקות היחידה גם באמצעות Docker. קודם כול, צריך לוודא שDocker מותקן. לאחר מכן, מהספרייה google-ads-python, מריצים את הפקודה הבאה:
docker build -t google-ads-python:test .
docker run -it google-ads-python:test nox
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-27 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-27 (שעון UTC)."],[[["\u003cp\u003eThe Google Ads Python library can be installed from PyPI using pip with the command \u003ccode\u003epython -m pip install google-ads\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eTo install from GitHub, clone the repository, navigate into it, and run \u003ccode\u003epython -m pip install .\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEnsure you have Python 3.8 or later installed in your environment, potentially using pyenv.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should run unit tests before and after making changes, utilizing nox or Docker for execution.\u003c/p\u003e\n"],["\u003cp\u003eFor library setup and usage, refer to the Virtual Environment and authentication example documentation.\u003c/p\u003e\n"]]],[],null,["# Installation\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nWhether you're installing the library from PyPI or cloning it from GitHub, we\nrecommended that you conduct the below steps using an active virtual\nenvironment. For information on how to create and activate a virtual\nenvironment, see the [Virtual Environment](//docs.python.org/3/tutorial/venv.html) documentation.\n\nInstall the module from PyPI\n----------------------------\n\nThe library is distributed on [PyPI](//pypi.org/project/google-ads/) and can\nbe installed using [pip](//pip.pypa.io/en/stable/installing) with the\nfollowing command: \n\n python -m pip install google-ads\n\nInstall the library from GitHub\n-------------------------------\n\nThe source code for the library can be cloned from [GitHub](https://github.com/googleads/google-ads-python/)\nonto your local machine. It's useful to clone the source code in order to easily\nexecute the examples or to develop the library itself. For reference, running\none of the authentication examples is a required step in configuring the library\nfor use.\n\n1. Ensure that `python3.8` or later is present in your environment.\n The simplest way is to use [`pyenv`](//github.com/pyenv/pyenv-installer):\n\n pyenv local 3.8\n\n2. Clone the client library from GitHub:\n\n git clone git@github.com:googleads/google-ads-python.git\n\n3. Enter the repository and install it:\n\n cd google-ads-python\n python -m pip install .\n\n4. If you intend to develop the library, run the unit tests before and after\n making any changes:\n\n 1. Ensure you have all supported versions of the Python language available in\n your environment. Using `pyenv`::\n\n pyenv local 3.8 3.9 3.10 3.11 3.12\n\n 2. Install the test-specific dependencies of the library:\n\n python -m pip install .[tests]\n\n 3. Run the unit tests to ensure the library is functioning properly:\n\n nox\n\n 4. Optional: the unit tests can also be run using Docker. First, you must\n have [Docker installed](https://docs.docker.com/get-docker/). Then, from\n the `google-ads-python` directory, run the following:\n\n docker build -t google-ads-python:test .\n docker run -it google-ads-python:test nox"]]
