Instalacja

Niezależnie od tego, czy instalujesz bibliotekę z PyPI, czy klonujesz ją z GitHuba, zalecamy wykonanie poniższych kroków przy użyciu aktywnego dla środowiska. Informacje o tym, jak utworzyć i aktywować wirtualną kartę zapoznaj się z dokumentacją środowiska wirtualnego.

Instalowanie modułu z PyPI

Biblioteka jest rozpowszechniana za pomocą PyPI i może należy zainstalować za pomocą polecenia pip z to polecenie:

python -m pip install google-ads

Zainstaluj bibliotekę z GitHuba

Kod źródłowy biblioteki można skopiować z GitHub na komputerze lokalnym. Warto sklonować kod źródłowy, by łatwo aby uruchomić przykłady lub opracować bibliotekę. W celach informacyjnych 1 z przykładów uwierzytelniania jest wymaganym krokiem w konfiguracji biblioteki do wykorzystania.

1. Sprawdź, czy w środowisku znajduje się 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 zawartość repozytorium i zainstaluj je:

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

4. Jeśli zamierzasz utworzyć bibliotekę, uruchom testy jednostkowe przed i po wprowadzenie zmian:

   1. Sprawdź, czy masz wszystkie obsługiwane wersje języka Python w z Twojego środowiska. Użycie pyenv:

      pyenv local 3.8 3.9 3.10 3.11 3.12
      

   2. Zainstaluj zależności zależne od biblioteki:

      python -m pip install .[tests]
      

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

      nox
      

   4. Opcjonalnie: testy jednostkowe możesz też uruchamiać przy użyciu Dockera. Najpierw musisz Dockera. Następnie z poziomu w katalogu google-ads-python, uruchom to polecenie:

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