Niezależnie od tego, czy instalujesz bibliotekę z PyPI, czy klonujesz ją z GitHuba, zalecamy wykonanie poniższych czynności w aktywnym środowisku wirtualnym. Informacje o tym, jak utworzyć i aktywować środowisko wirtualne, znajdziesz w dokumentacji środowiska wirtualnego.
Instalowanie modułu z PyPI
Biblioteka jest rozpowszechniana w PyPI i można ją zainstalować za pomocą narzędzia pip za pomocą tego polecenia:
python -m pip install google-ads
Zainstaluj bibliotekę z GitHuba
Kod źródłowy biblioteki można skopiować z GitHub na komputer lokalny. Aby łatwo wykonać przykłady lub rozwinąć samą bibliotekę, warto sklonować kod źródłowy. Uruchomienie jednego z przykładów uwierzytelniania jest wymaganym etapem konfigurowania biblioteki do użytku.
Upewnij się, że w Twoim środowisku jest dostępna usługa
python3.8
lub nowsza. Najprostszym sposobem jest użyciepyenv
:pyenv local 3.8
Sklonuj bibliotekę klienta z GitHuba:
git clone git@github.com:googleads/google-ads-python.git
Wpisz i zainstaluj repozytorium:
cd google-ads-python python -m pip install .
Jeśli zamierzasz rozwijać bibliotekę, przeprowadź testy jednostkowe przed wprowadzeniem zmian i po nich:
Sprawdź, czy w swoim środowisku dostępne są wszystkie obsługiwane wersje języka Python. Przy użyciu
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]
Aby sprawdzić, czy biblioteka działa prawidłowo, uruchom testy jednostkowe:
nox
Opcjonalnie: testy jednostkowe możesz też uruchamiać za pomocą Dockera. Najpierw musisz zainstalować Dockera. Następnie z katalogu
google-ads-python
uruchom to polecenie:docker build -t google-ads-python:test . docker run -it google-ads-python:test nox