Biblioteka klienta w Pythonie jest hostowana na GitHubie, a pakiet jest dostępny na PyPI.
Wymagania
Biblioteka obsługuje Pythona w wersjach od 3.9 do 3.14 (>=3.9, <3.15; obsługa Pythona 3.14 została dodana w v28.2.0). Ponieważ Python 3.9 i 3.10 wyświetlają ostrzeżenie o wycofaniu podczas importowania w google-ads v32.0.0 i nowszych wersjach, 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 w Pythonie 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ół Google Ads API dąży do wdrażania nowych wersji środowiska wykonawczego Pythona, gdy tylko zostaną wydane i oficjalnie zatwierdzone przez Python Software Foundation.
Środowiska wykonawcze Pythona, które osiągnęły koniec cyklu życia (EOL), nie są obsługiwane po dacie EOL podanej w sekcji Nieobsługiwane wersje na stronie python.org. Nie możemy zagwarantować zgodności ze środowiskami wykonawczymi, które osiągnęły koniec cyklu życia, ponieważ wersje biblioteki wydane po dacie zakończenia cyklu życia mogą nie być z nimi zgodne.
W przypadku zależności (w szczególności pakietów utrzymywanych przez Google, które są wymienione jako wymagane przez bibliotekę klienta Pythona) zgodność jest utrzymywana z pakietami, które są utrzymywane przez Google i uznawane za „obsługiwane” zgodnie z zasadami Google dotyczącymi 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
W przewodniku instalacji znajdziesz 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ć. Bibliotekę można skonfigurować na kilka sposobów, które opisano w przewodniku po konfiguracji.
Uwierzytelnianie
Po wybraniu metody konfiguracji skonfiguruj uwierzytelnianie. Szczegółowe instrukcje znajdziesz w przewodniku po uwierzytelnianiu biblioteki klienta w Pythonie. Więcej ogólnych informacji znajdziesz w omówieniu protokołu 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ładową aplikację get_campaigns.py, najpierw sklonuj repozytorium google-ads-python. Następnie w katalogu głównym sklonowanego repozytorium uruchom to polecenie:
python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE
Dodatkowe materiały
Gdy uda Ci się wysłać żądanie do interfejsu API, przejdź do tych zastosowań biblioteki klienta: