Bibliotekę można skonfigurować do rejestrowania interakcji 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 konfiguracja biblioteki klienta. Poniżej znajdziesz szczegółowy opis dostępnych opcji konfiguracji.
Domyślnie biblioteka używa wbudowanej platformy logging w języku Python i logów w stderr. Jeśli zostanie uwzględniony, obiekt logging zdefiniowany w konfiguracji jest przekazywany bezpośrednio do logging.config.dictConfig jako dict.
Logowanie możesz też skonfigurować programowo, ustawiając konfigurację logowania przed zainicjowaniem klienta. Możesz pobrać instancję rejestrującego klienta i skonfigurować ją w tym przykładzie:
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. Wszelkie późniejsze zmiany w konfiguracji logowania będą ignorowane. Aby automatycznie zastąpić 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 ustawić w swojej konfiguracji wyświetlanie niektórych lub wszystkich z tych 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. |
Platforma logowania Pythona ignoruje komunikaty logu, które są mniej poważne niż skonfigurowany poziom, ustawienie WARNING oznacza, że będziesz widzieć tylko zwięzłe komunikaty dotyczące nieudanych żądań, a ustawienie DEBUG oznacza, że w powyższej tabeli zobaczysz wszystkie możliwe typy logów.
Logowanie do pliku
Możesz z łatwością przesyłać komunikaty logów do pliku za pomocą potoku, na przykład przy uruchamianiu przykładowego narzędzia get_campaigns:
python get_campaigns.py -c $CLIENT_ID 2> example.log
Rejestrowanie elementów przechwytujących
Biblioteka klienta Pythona używa przechwytujących gRPC do uzyskiwania dostępu do szczegółów żądań i odpowiedzi oraz logowania ich. Możesz skonfigurować własne logowanie niestandardowe, tworząc przechwytujący gRPC z niestandardową logiką. Więcej informacji i przykład niestandardowego przechwytującego logów znajdziesz w przewodniku po logowaniu.