Bibliotekę można skonfigurować tak, aby rejestrowała 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 podsumowania. Tymi ustawieniami zarządza konfiguracja biblioteki klienta. Poniżej znajdziesz szczegółowe informacje o dostępnych typach opcji konfiguracji.
Biblioteka korzysta z wbudowanego w Pythonie ramowego systemu rejestrowania i domyślnie zapisuje dzienniki w pliku stderr. Jeśli jest podany, zdefiniowany w konfiguracji obiekt logging 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ę klienta loggera 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 konfigurowany podczas inicjowania klienta. Wszystkie kolejne zmiany w konfiguracji rejestrowania zostaną zignorowane. Aby zastąpić konfigurację rejestrowania w pliku YAML za pomocą kodu, wywołaj powyższe wiersze przed zainicjowaniem klienta.
Poziomy rejestrowania
Klient generuje dzienniki na kilku różnych poziomach, a w konfiguracji możesz ustawić, aby wyświetlać niektóre z tych informacji lub wszystkie:
| Poziom | Pomyślna prośba | Nieudane żądanie |
|---|---|---|
DEBUG |
szczegółowy dziennik z pełnymi obiektami żądania i odpowiedzi w formacie JSON; | szczegółowy dziennik z pełnymi obiektami żądania i wyjątków w formacie JSON; |
INFO |
zwięzłe podsumowanie z konkretnymi polami żądania i odpowiedzi; | szczegółowy dziennik z pełnymi obiektami żądania i wyjątków w formacie JSON; |
WARNING |
Brak | Zwięzłe podsumowanie z konkretnymi informacjami o żądaniu, stanem wyjątku i komunikatem. |
Framework Python do rejestrowania danych ignoruje komunikaty o mniejszym znaczeniu niż skonfigurowany poziom. Ustawienie WARNING spowoduje, że zobaczysz tylko zwięzłe komunikaty dotyczące nieudanych żądań, a ustawienie DEBUG spowoduje, że zobaczysz wszystkie możliwe typy logów w tabeli powyżej.
Logowanie do pliku
Możesz łatwo przesłać wiadomości z dziennika do pliku. Na przykład podczas uruchamiania przykładu get_campaigns:
python get_campaigns.py -c $CLIENT_ID 2> example.log
Przechwytywanie logów
Biblioteka klienta Pythona używa przechwytników gRPC do uzyskiwania dostępu do szczegółów żądań i odpowiedzi oraz ich rejestrowania. Możesz skonfigurować własne niestandardowe rejestrowanie, tworząc przechwytywanie gRPC z niestandardową logiką. Więcej informacji oraz przykład niestandardowego przechwytywania logów znajdziesz w przewodniku dotyczącym rejestrowania danych.