Logowanie

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Biblioteka może być skonfigurowana tak, aby rejestrować 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 wiadomości z podsumowaniem. Tymi ustawieniami zarządza konfiguracja biblioteki klienta. Poniżej znajdziesz szczegółowe informacje o różnych dostępnych opcjach konfiguracji.

Biblioteka korzysta domyślnie z wbudowanegoschematu i logów stderr języka Python. Jeśli określisz obiekt logging zdefiniowany w konfiguracji, zostanie przekazany bezpośrednio do logging.config.dictConfig jako dict.

Logowanie możesz też skonfigurować automatycznie, ustawiając konfigurację logowania przed zainicjowaniem klienta. Możesz pobrać instancję 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)

Pamiętaj, że rejestrator klienta jest skonfigurowany po zainicjowaniu klienta. 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 rejestrowania

Klient generuje logi na kilku różnych poziomach. Możesz skonfigurować konfigurację tak, aby zobaczyć niektóre lub wszystkie te elementy:

Poziom Żądanie zakończone powodzeniem Nieudane żądanie
DEBUG Szczegółowy log z pełnym obiektem żądania i odpowiedzi w formacie JSON. Szczegółowy dziennik z pełnymi obiektami żądań i wyjątków w formacie JSON.
INFO Krótkie podsumowanie z konkretnymi polami żądania i odpowiedzi. Szczegółowy dziennik z pełnymi obiektami żądań i wyjątków w formacie JSON.
WARNING Brak Krótkie podsumowanie z konkretnymi informacjami o żądaniu, stanem wyjątku i komunikatem.

Platforma logowania dla języka Python ignoruje wiadomości logu o mniej szczegółowym poziomie niż skonfigurowany poziom, więc ustawienie WARNING oznacza, że wyświetlane są tylko komunikaty dotyczące nieuwierzytelnionych żądań. Ustawienie DEBUG oznacza, że w tabeli powyżej wyświetlane są wszystkie możliwe typy logów.

Logowanie do pliku

Możesz łatwo przenosić wiadomości logu do pliku, na przykład podczas uruchamiania przykładu get_campaigns:

python get_campaigns.py -c $CLIENT_ID 2> example.log

Przechwytywanie dzienników

Biblioteka klienta w Pythonie używa przechwytujących gRPC, aby uzyskać dostęp do szczegółów żądań i odpowiedzi oraz zapisywać je. Możesz skonfigurować własne logowanie, tworząc przechwytujący gRPC z niestandardową logiką. Więcej informacji na ten temat znajdziesz w przewodniku logowania.