Biblioteka klienta Python jest hostowana na GitHubie, a pakiet jest dostępny w PyPI.
Wymagania
Biblioteka obsługuje Pythona w wersji od 3.9 do 3.14 (>=3.9, <3.15; obsługa Pythona 3.14
została dodana w wersji v28.2.0). Ponieważ Python 3.9 i 3.10 emitują ostrzeżenie o wycofaniu
podczas importowania w google-ads v32.0.0 i nowszych, zalecamy używanie Pythona 3.11 lub
nowszego.
Wymagania wstępne
Zanim przejdziesz dalej, musisz mieć 10-cyfrowy identyfikator klienta konta Google Ads.
Zgodność środowiska wykonawczego i zależności
Biblioteka klienta Python zachowuje zgodność ze środowiskami wykonawczymi Pythona w sekcji Obsługiwane wersje opublikowanej przez Python Software Foundation, z wyjątkiem wersji o stanie "funkcja" lub "wersja przedpremierowa".
Zespół interfejsu Google Ads API dąży do jak najszybszego wdrażania nowych wersji środowiska wykonawczego Pythona, gdy tylko zostaną one wydane i oficjalnie obsługiwane przez Python Software Foundation.
Środowiska wykonawcze Pythona, które osiągnęły koniec cyklu życia (EOL), nie są obsługiwane po dacie zakończenia cyklu życia w sekcji Nieobsługiwane wersje na stronie python.org. Nie można zagwarantować zgodności ze środowiskami wykonawczymi EOL, ponieważ wersje biblioteki wydane po dacie EOL mogą powodować utratę zgodności.
W przypadku zależności (w szczególności wszystkich pakietów utrzymywanych przez Google, które są wymienione jako wymagane przez bibliotekę klienta Python) zachowywana jest zgodność z pakietami utrzymywanymi przez Google i uznawanymi za "obsługiwane" zgodnie z polityką Google dotyczącą zmian powodujących niezgodność w oprogramowaniu open source.
Pełną listę obsługiwanych środowisk wykonawczych i zależności Pythona znajdziesz na stronie Zależności.
Instalacja
Przewodnik instalacji zawiera wszystkie sposoby instalowania biblioteki. Najprostszym (i zalecanym) sposobem zainstalowania biblioteki w aplikacji jest użycie pip:
python -m pip install google-ads
Konfiguracja
Po zainstalowaniu biblioteki musisz ją skonfigurować. Istnieje kilka sposobów konfigurowania biblioteki, które są opisane w przewodniku po konfiguracji.
Uwierzytelnianie
Po wybraniu sposobu konfiguracji skonfiguruj uwierzytelnianie. Szczegółowe instrukcje znajdziesz w przewodniku po uwierzytelnianiu w bibliotece klienta Python. Więcej ogólnych informacji znajdziesz w omówieniu OAuth.
Wysyłanie żądania do interfejsu API
Po skonfigurowaniu uwierzytelniania możesz wysłać żądanie do interfejsu API. Aby szybko sprawdzić, czy biblioteka jest prawidłowo skonfigurowana do wysyłania żądań do interfejsu API, zapoznaj się z przykładem pobierania kampanii.
Aby uruchomić przykład get_campaigns.py, najpierw skopiuj repozytorium
google-ads-python. Następnie w katalogu głównym skopiowanego repozytorium uruchom to polecenie:
python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE
Dodatkowe materiały
Gdy będziesz mieć możliwość wysyłania żądań do interfejsu API, zapoznaj się z tymi zastosowaniami biblioteki klienta: