Instalacja
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Niezależnie od tego, czy instalujesz bibliotekę z PyPI, czy klonujesz ją z GitHub, zalecamy wykonanie poniższych czynności w aktywnym środowisku wirtualnym. Informacje o tworzeniu i aktywacji środowiska wirtualnego znajdziesz w dokumentacji Virtual Environment (Środowisko wirtualne).
Zainstaluj moduł z PyPI
Biblioteka jest rozpowszechniana w PyPI i można ją zainstalować za pomocą pip, używając tego polecenia:
python -m pip install google-ads
Instalowanie biblioteki z GitHuba
Kod źródłowy biblioteki można sklonować z GitHub na komputer lokalny. Klonowanie kodu źródłowego jest przydatne, ponieważ ułatwia wykonywanie przykładów i rozwijanie biblioteki. Uruchomienie jednego z przykładów uwierzytelniania jest niezbędnym krokiem podczas konfigurowania biblioteki do użycia.
Upewnij się, że w Twoim środowisku jest zainstalowana wersja python3.8 lub nowsza.
Najprostszym sposobem jest użycie pyenv:
pyenv local 3.8
Sklonuj bibliotekę klienta z GitHuba:
git clone git@github.com:googleads/google-ads-python.git
Wpisz repozytorium i zainstaluj je:
cd google-ads-python
python -m pip install .
Jeśli planujesz rozwijać bibliotekę, uruchamiaj testy jednostkowe przed wprowadzeniem zmian i po ich wprowadzeniu:
Sprawdź, czy w środowisku masz wszystkie obsługiwane wersje języka Python. Używanie pyenv:
pyenv local 3.8 3.9 3.10 3.11 3.12
Zainstaluj zależności biblioteki związane z testami:
python -m pip install .[tests]
Uruchom testy jednostkowe, aby sprawdzić, czy biblioteka działa prawidłowo:
nox
Opcjonalnie: testy jednostkowe można też uruchamiać za pomocą Dockera. Najpierw musisz zainstalować Dockera. Następnie w katalogu google-ads-python uruchom to polecenie:
docker build -t google-ads-python:test .
docker run -it google-ads-python:test nox
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-27 UTC.
[null,null,["Ostatnia aktualizacja: 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"]]
