Bibliotekę można skonfigurować pod kątem rejestrowania interakcji z interfejsem Google Ads API na różne sposoby. Możesz rejestrować szczegółowe żądania i odpowiedzi oraz bardziej zwięzłe podsumowania. Tymi ustawieniami zarządza konfiguracja biblioteki klienta. Poniżej opisujemy różne dostępne opcje konfiguracji.
Domyślnie biblioteka korzysta z wbudowanej platformy logowania i logów Pythona w stderr
. Jeśli zostanie uwzględniony, obiekt logging
zdefiniowany w konfiguracji jest przekazywany bezpośrednio do logging.config.dictConfig
jako dict
.
Możesz też skonfigurować logowanie programowo, ustawiając konfigurację logowania przed zainicjowaniem klienta. Możesz pobrać instancję rejestratora klienta i skonfigurować ją za pomocą tego przykładu:
import logging
logging.basicConfig(level=logging.INFO, format='[%(asctime)s - %(levelname)s] %(message).5000s')
logging.getLogger('google.ads.googleads.client').setLevel(logging.INFO)
Rejestrator klienta jest konfigurowany po zainicjowaniu klienta. Wszystkie kolejne 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. Możesz dostosować swoją konfigurację, aby wyświetlać niektóre lub wszystkie z poniższych elementów:
Poziom | Udane żądanie | Nieudane żądanie |
---|---|---|
DEBUG |
Szczegółowy dziennik z pełnymi obiektami żądań i odpowiedzi w formacie JSON. | Szczegółowy dziennik z pełnymi obiektami żądań i wyjątków w formacie JSON. |
INFO |
zwięzłe podsumowanie z określonymi polami żądania i odpowiedzi. | Szczegółowy dziennik z pełnymi obiektami żądań i wyjątków w formacie JSON. |
WARNING |
Brak | Zwięzłe podsumowanie z informacjami na temat konkretnej prośby, stanem wyjątku i komunikatem. |
Platforma logowania w Pythonie ignoruje komunikaty logu, które są mniej poważne niż skonfigurowany poziom, dlatego ustawienie wartości WARNING
oznacza, że widoczne będą tylko zwięzłe komunikaty związane z nieudanymi żądaniami. Ustawienie DEBUG
oznacza, że w tabeli powyżej będą się wyświetlać wszystkie możliwe typy logów.
Logowanie do pliku
Możesz z łatwością umieszczać komunikaty dziennika za pomocą potoku do pliku, na przykład podczas uruchamiania kodu get_campaigns
:
python get_campaigns.py -c $CLIENT_ID 2> example.log
Przechwytujące dane
Biblioteka klienta w języku Python używa przechwytujących gRPC do uzyskiwania dostępu do żądań i odpowiedzi oraz rejestrowania ich szczegółów. Możesz skonfigurować własne logowanie, tworząc przechwytywanie gRPC z niestandardową logiką. Więcej informacji i przykład niestandardowego narzędzia do przechwytywania logów znajdziesz w przewodniku po logowaniu.