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 do interfejsu Google Ads API oraz 10-cyfrowy identyfikator klienta na koncie 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 oznaczonych jako „feature” lub „prerelease”.
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 podanej w sekcji Nieobsługiwane wersje na stronie python.org. Nie możemy zagwarantować zgodności z wersjami środowiska wykonawczego po zakończeniu ich wsparcia, ponieważ w dowolnym momencie po tej dacie możemy udostępnić wersję biblioteki, która nie będzie z nimi zgodna.
W przypadku zależności (w szczególności pakietów utrzymywanych przez Google, które są wymagane przez bibliotekę klienta Python) zachowamy zgodność z pakietami utrzymywanymi przez Google, które są 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 Pythona i zależności 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ć. Bibliotekę można skonfigurować na kilka sposobów, które opisaliśmy w naszym przewodniku po konfiguracji.
Uwierzytelnianie
Po wybraniu podejścia do konfiguracji możesz skonfigurować uwierzytelnianie. Szczegółowe instrukcje znajdziesz w naszym przewodniku po uwierzytelnianiu w bibliotece klienta Python, 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. Zapoznaj się z przykładem get campaigns, aby szybko sprawdzić, czy biblioteka jest prawidłowo skonfigurowana do wysyłania żądań API.
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, przejdź do tych zastosowań biblioteki klienta: