Biblioteka klienta w Pythonie jest hostowana na GitHubie, a pakiet jest dostępny w 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 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 Python w sekcji Obsługiwane wersje opublikowanej przez Python Software Foundation, z wyjątkiem wersji o stanie „funkcja” lub „wersja wstępna”.
Zespół interfejsu Google Ads API stara 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żna zagwarantować zgodności z wersjami środowiska wykonawczego po zakończeniu okresu ich wsparcia, ponieważ wydania biblioteki po tej dacie mogą spowodować utratę zgodności.
W przypadku zależności (w szczególności wszystkich pakietów utrzymywanych przez Google, które są wymagane przez bibliotekę klienta Python) zgodność jest zachowywana z pakietami utrzymywanymi przez Google i uznawanymi 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 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 przewodniku po konfiguracji.
Uwierzytelnianie
Po wybraniu sposobu konfiguracji skonfiguruj uwierzytelnianie. Szczegółowe instrukcje znajdziesz w przewodniku uwierzytelniania biblioteki klienta Python. Więcej informacji znajdziesz w omówieniu OAuth.
Wysyłanie żądania do interfejsu API
Po skonfigurowaniu uwierzytelniania możesz wysłać żądanie do interfejsu API. W przykładzie get campaigns znajdziesz szybki sposób na sprawdzenie, czy biblioteka jest prawidłowo skonfigurowana do wysyłania żądań do interfejsu API.
Aby uruchomić przykładowy kod get_campaigns.py, najpierw sklonuj google-ads-python repozytorium. 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 będziesz w stanie wysłać żądanie do interfejsu API, przejdź do tych zastosowań biblioteki klienta: