Bibliotekę można skonfigurować tak, aby rejestrowała interakcje z interfejsem Google Ads API na różne sposoby. Możesz rejestrować szczegółowe żądania i odpowiedzi, a także bardziej zwięzłe podsumowania. Tymi ustawieniami zarządza konfiguracji biblioteki klienta. Poniżej znajdziesz szczegółowe informacje na temat różne typy opcji konfiguracji.
Biblioteka korzysta z wbudowanych funkcji logowania w języku Python.
platformy i logów do stderr. Obiekt logging, jeśli jest uwzględniony
zdefiniowane w konfiguracji jest przekazywane bezpośrednio do
logging.config.dictConfig.
jako dict.
Logowanie możesz też skonfigurować programowo konfigurację, zanim zainicjujesz klienta. Możesz pobrać klienta, w instancji loggera i skonfiguruj ją w następujący sposób:
import logging
logging.basicConfig(level=logging.INFO, format='[%(asctime)s - %(levelname)s] %(message).5000s')
logging.getLogger('google.ads.googleads.client').setLevel(logging.INFO)
Pamiętaj, że rejestrator klienta jest konfigurowany podczas inicjowania klienta. Dowolne kolejne zmiany w konfiguracji logowania będą ignorowane. Aby programowo zastąp konfigurację logowania w pliku YAML, wywołaj powyższe wiersze przed zainicjowaniem klienta.
Poziomy logu
Klient generuje logi na kilku różnych poziomach i możesz aby wyświetlić niektóre lub wszystkie z poniższych elementów:
| Poziom | Żądanie przetworzone | Nieudane żądanie |
|---|---|---|
DEBUG |
Szczegółowy dziennik z kompletnymi obiektami żądań i odpowiedzi w formacie JSON. | Szczegółowy dziennik z kompletnymi obiektami żądań i wyjątków w formacie JSON. |
INFO |
zwięzłe podsumowanie z konkretnymi polami żądania i odpowiedzi. | Szczegółowy dziennik z kompletnymi obiektami żądań i wyjątków w formacie JSON. |
WARNING |
Brak | zwięzłe podsumowanie zawierające informacje o konkretnej prośbie, stan wyjątku i komunikat. |
Ponieważ platforma logowania Pythona ignoruje mniej ważne komunikaty logu
niż skonfigurowany, ustawienie WARNING oznacza, że zobaczysz tylko
zwięzłych komunikatów związanych z nieudanymi żądaniami, ale ustawienie DEBUG oznacza,
zobaczysz wszystkie możliwe typy logów w powyższej tabeli.
Logowanie do pliku
Możesz z łatwością przesyłać komunikaty dziennika potokiem do pliku. na przykład podczas uruchamiania
Przykład strony get_campaigns:
python get_campaigns.py -c $CLIENT_ID 2> example.log
Rejestrowanie elementów przechwytujących
Biblioteka klienta w Pythonie korzysta z gRPC elementy przechwytujące umożliwiające dostęp do żądań i rejestrowanie ich i szczegółach odpowiedzi. Możesz skonfigurować własne logowanie niestandardowe, tworząc gRPC z niestandardową logiką. Patrz sekcja Logowanie przewodnik .