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ć 10-cyfrowy identyfikator klienta konta Google Ads.
Zgodność środowiska wykonawczego i zależności
Biblioteka klienta Python zachowuje zgodność ze środowiskami wykonawczymi Python w sekcji Obsługiwane wersje opublikowanej przez Python Software Foundation, z wyjątkiem wersji ze stanem "funkcja" lub "wersja wstępna".
Staramy się wdrażać nowe wersje środowiska wykonawczego Python, gdy tylko zostaną one wydane i oficjalnie obsługiwane przez Python Software Foundation.
Środowiska wykonawcze Python, 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 konfiguracji biblioteki, które są opisane w naszym przewodniku po konfiguracji.
Uwierzytelnianie
Po wybraniu sposobu konfiguracji możesz skonfigurować uwierzytelnianie. Szczegółowe instrukcje znajdziesz w przewodniku po uwierzytelnianiu w bibliotece klienta Python guide, a ogólne informacje – 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, 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: