Biblioteka klienta Python jest hostowana w GitHubie, a pakiet jest dostępny w PyPI.
Wymagania
Biblioteka wymaga Pythona w wersji 3.9 lub nowszej.
Wymagania wstępne
Zanim przejdziesz dalej, musisz mieć token programisty interfejsu Google Ads API oraz 10-cyfrowy identyfikator klienta konta Google Ads.
Zgodność środowiska wykonawczego i zależności
Biblioteka klienta Python jest zgodna ze środowiskami wykonawczymi Pythona wymienionymi w sekcji Obsługiwane wersje opublikowanej przez Python Software Foundation, z wyjątkiem wersji o stanie "funkcja" lub "wersja wstępna".
Staramy się wdrażać nowe wersje ś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, nie są obsługiwane po dacie zakończenia cyklu życia 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ż w dowolnym momencie po dacie zakończenia cyklu życia możemy wydać wersję biblioteki, która jest z nimi niezgodna.
W przypadku zależności (w szczególności pakietów utrzymywanych przez Google, które są wymienione jako wymagane przez bibliotekę klienta Python) będziemy utrzymywać zgodność 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 naszym 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ć. Istnieje kilka sposobów konfigurowania biblioteki, które są opisane w naszym przewodniku po konfiguracji.
Uwierzytelnianie
Po wybraniu sposobu konfiguracji możesz skonfigurować uwierzytelnianie. Szczegółowe instrukcje znajdziesz w naszym przewodniku po uwierzytelnianiu w bibliotece klienta Python, a ogólne informacje – w naszym 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, w katalogu głównym lokalnie zainstalowanej biblioteki klienta googleads-python uruchom to polecenie:
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_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: