Przegląd

Biblioteka klienta Pythona jest hostowana na GitHubie, a pakiet jest dostępny w PyPI.

Wymagania

Biblioteka wymaga Pythona w wersji 3.8 lub nowszej.

Wymagania wstępne

Przed zainstalowaniem biblioteki będzie potrzebny token programisty oraz identyfikatora klienta. Instrukcje, jak je uzyskać, znajdziesz w wymagań wstępnych. Pamiętaj, że inne wymagane tokeny OAuth2 wygenerujesz w późniejszych krokach.

Zgodność środowiska wykonawczego i zależności

Biblioteka klienta Pythona zachowuje zgodność ze środowiskami wykonawczymi Pythona w Obsługiwane wersje opublikowane przez Python Software Foundation z wyjątkiem wersje ze stanem „funkcja” lub „przedpremierowa”.

Wdrażając nowe wersje środowiska wykonawczego Pythona, chcemy opublikować wersji biblioteki klienta w Pythonie, zgodnej z najnowszym środowiskiem wykonawczym. do końca kwartału po jego premierze. Jeśli na przykład nowe środowisko wykonawcze zostanie udostępniona w październiku, kompatybilna wersja biblioteki klienta dla języka Python zostanie udostępniona do końca marca następnego roku.

Środowiska wykonawcze Pythona, które osiągnęły koniec cyklu życia (EOL), nie są obsługiwane po Data końca okresu eksploatacji w Sekcja Nieobsługiwane wersje python.org

W dowolnym momencie po zakończeniu ich obsługi możemy udostępnić wersję biblioteki klienta Python, która jest niezgodna z nieobsługiwanymi środowiskami wykonawczymi Pythona.

W przypadku zależności (w szczególności pakietów obsługiwanych przez Google, które są wymienione jako wymagane przez bibliotekę klienta Pythona) będziemy dbać o zgodność z pakietami obsługiwanymi przez Google i uważanymi za „obsługiwane” zgodnie z zasadami Google dotyczącymi wprowadzania zmian w oprogramowaniu open source.

Pełną listę obsługiwanych środowisk wykonawalnych i zależnych Pythona znajdziesz na stronie Zależności.

Instalacja

Postępuj zgodnie z instrukcjami podanymi w naszej instalacji. dokumentacji umożliwiającej zainstalowanie biblioteki z PyPi i powrót na tę stronę.

Konfiguracja

Po zainstalowaniu biblioteki musisz skonfigurować . Bibliotekę można skonfigurować na wiele sposobów, które opisano w konfiguracji.

Uwierzytelnianie

Po wybraniu typu konfiguracji możesz przejść do generowania pliku pozostałe tokeny OAuth2 potrzebne do wysyłania żądań do interfejsu API. Istnieje kilka obsługiwanych przepływów OAuth2, które zostały opisane na liście poniżej. Więcej informacji: różnic między procesami i pomóc w podjęciu decyzji, który z nich będzie najlepszy dla Twojej firmy. aplikacji można znaleźć w naszej dokumentacji OAuth.

Tworzenie żądania do interfejsu API

Po dodaniu tokenów OAuth2 do konfiguracji możesz wysłać żądanie do interfejsu API. Aby dowiedzieć się, jak łatwo sprawdzić, czy biblioteka jest prawidłowo skonfigurowana do wysyłania żądań do interfejsu API, zapoznaj się z przykładem get campaigns.

Aby uruchomić przykładową aplikację get_campaigns.py, w katalogu głównym swojego lokalnego folderu zainstalowano bibliotekę 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ść wysłania żądania do interfejsu API, przejdź do tych sposobów wykorzystania klienta biblioteka: