Bibliotekę można skonfigurować do rejestrowania interakcji z interfejsem Google Ads API na różne sposoby. Możesz rejestrować szczegółowe żądania i odpowiedzi oraz zwięzłe podsumowania. Tymi ustawieniami zarządza konfiguracja biblioteki klienta. Poniżej znajdziesz szczegółowe informacje o różnych dostępnych opcjach konfiguracji.
Biblioteka korzysta z wbudowanej platformy logowania i logów Pythona do obsługi stderr. Jeśli tak, obiekt logging zdefiniowany w konfiguracji zostanie przekazany bezpośrednio do logging.config.dictConfig jako dict.
Logowanie możesz też skonfigurować automatycznie, konfigurując funkcję 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)
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, musisz wywołać powyższe wiersze przed zainicjowaniem klienta.
Poziomy logów
Klient generuje logi na kilku różnych poziomach i możesz skonfigurować konfigurację, aby wyświetlić niektóre lub wszystkie z tych elementów:
| Poziom | Prośba została zrealizowana | Nieudana prośba |
|---|---|---|
DEBUG |
Szczegółowy dziennik z obiektami JSON żądania i odpowiedzi. | Szczegółowy dziennik z obiektami JSON żądania i wyjątków. |
INFO |
zwięzłe podsumowanie zawierające konkretne pola żądania i odpowiedzi; | Szczegółowy dziennik z obiektami JSON żądania i wyjątków. |
WARNING |
Brak | Krótkie podsumowanie z określonymi informacjami o żądaniu, stanem wyjątku i komunikatem. |
Platforma logowania Pythona ignoruje wiadomości logu mniej ważne niż skonfigurowany poziom, więc ustawienie WARNING oznacza tylko zwięzłe wiadomości dotyczące nieudanych żądań, a ustawienie DEBUG oznacza, że w tabeli powyżej zobaczysz wszystkie możliwe typy logów.
Logowanie do pliku
Możesz z łatwością potokować komunikaty dziennika do plików, na przykład gdy uruchamiasz przykład get_campaigns:
python get_campaigns.py -c $CLIENT_ID 2> example.log
Przechwytywanie dzienników
Biblioteka klienta w Pythonie korzysta z osób przechwytywania gRPC, aby uzyskiwać dostęp do szczegółów żądań i odpowiedzi oraz rejestrować je. Możesz skonfigurować własne logowanie niestandardowe, tworząc przechwytujący gRPC z niestandardową logiką. Więcej informacji oraz przykład niestandardowego przechwytywania logów znajdziesz w przewodniku na temat logowania.