Logowanie

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.