Instalacja

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.

  1. Upewnij się, że w Twoim środowisku jest zainstalowana wersja python3.8 lub nowsza. Najprostszym sposobem jest użycie pyenv:

    pyenv local 3.8

  2. Sklonuj bibliotekę klienta z GitHuba:

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

  3. Wpisz repozytorium i zainstaluj je:

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

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

    1. 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

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

      python -m pip install .[tests]

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

      nox

    4. 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