Instalacja

Niezależnie od tego, czy instalujesz bibliotekę z PyPI, czy klonujesz ją z GitHuba, wykonaj te czynności w aktywnym środowisku wirtualnym. Informacje o tym, jak utworzyć i aktywować środowisko wirtualne, znajdziesz w dokumentacji środowiska wirtualnego.

Aby szybko utworzyć i aktywować środowisko wirtualne:

python3 -m venv env
source env/bin/activate

Instalowanie modułu 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

Zweryfikuj instalację

Sprawdź, czy moduł został prawidłowo zainstalowany:

python -c "import google.ads.googleads"

Instalowanie biblioteki z GitHuba

Kod źródłowy biblioteki można sklonować z GitHub na komputer lokalny. Sklonowanie kodu źródłowego jest przydatne do wykonywania przykładów lub rozwijania samej biblioteki. Uruchomienie jednego z przykładów uwierzytelniania jest wymaganym krokiem podczas konfigurowania biblioteki do użycia.

  1. Sprawdź, czy w środowisku jest obsługiwana wersja Pythona (od 3.9 do 3.14; zalecana jest wersja 3.11 lub nowsza). Najprostszy sposób to użycie pyenv:

    pyenv install 3.13
pyenv local 3.13

  2. Sklonuj bibliotekę klienta z GitHuba:

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

  3. Wejdź do repozytorium i zainstaluj je w trybie edycji:

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

  4. Jeśli zamierzasz rozwijać bibliotekę, przed wprowadzeniem jakichkolwiek zmian i po ich wprowadzeniu uruchom testy jednostkowe:

    1. Sprawdź, czy w środowisku są dostępne wszystkie obsługiwane wersje języka Python, używając polecenia pyenv:

      pyenv local 3.9 3.10 3.11 3.12 3.13 3.14

    2. Zainstaluj zależności biblioteki związane z testami:

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

    3. Uruchom testy jednostkowe, aby sprawdzić, czy biblioteka działa prawidłowo:

      nox

    4. Opcjonalnie: możesz też uruchomić testy jednostkowe za pomocą Dockera. Najpierw upewnij się, że masz zainstalowanego Dockera. Następnie w katalogu google-ads-python uruchom te polecenia:

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