Włącz logowanie

Biblioteka zapewnia wszechstronne rejestrowanie interakcji z interfejsem Google Ads API. Możesz rejestrować:

  • Szczegółowe informacje: pełne żądania wysyłane do interfejsu API i otrzymywane odpowiedzi.
  • Zwięzłe podsumowania: ogólne omówienia interakcji z interfejsem API.

Ustawieniami logowania możesz zarządzać na 2 sposoby:

  • Konfiguracja biblioteki klienta: użyj opcji konfiguracji biblioteki w pliku google-ads.yaml lub zmiennych środowiskowych.
  • Programowo w Pythonie: użyj wbudowanej platformy logging Pythona, aby mieć bezpośrednią kontrolę.

Konfigurowanie za pomocą google-ads.yaml

Rejestrowanie jest konfigurowane automatycznie podczas inicjowania instancji GoogleAdsClient (np. gdy wywołasz load_from_storage). Podczas inicjowania biblioteka:

Możesz na przykład dodać sekcję logging do pliku google-ads.yaml:

logging:
  version: 1
  disable_existing_loggers: false
  formatters:
    default_fmt:
      format: '[%(asctime)s - %(levelname)s] %(message).5000s'
      datefmt: '%Y-%m-%d %H:%M:%S'
  handlers:
    default_handler:
      class: logging.StreamHandler
      formatter: default_fmt
  loggers:
    '':
      handlers: [default_handler]
      level: INFO

Konfigurowanie automatyczne

Jeśli używasz biblioteki jako zainstalowanego pakietu bez sekcji logging w pliku konfiguracyjnym, możesz zintegrować jej rejestrowanie z rejestrowaniem aplikacji za pomocą programu konfiguracji. Dołącz do instancji rejestratora biblioteki (google.ads.googleads.client) moduł obsługi logowania za pomocą addHandler i ustaw docelowy poziom logowania:

import logging
import sys

# Retrieve the library's logger instance.
logger = logging.getLogger("google.ads.googleads.client")

# Direct logs to standard output (stdout).
logger.addHandler(logging.StreamHandler(sys.stdout))

# Set the log level to DEBUG to view detailed messages.
logger.setLevel(logging.DEBUG)

Jeśli wolisz wysyłać logi do standardowego wyjścia błędów (stderr), które jest często używane w przypadku komunikatów o błędach i ostrzeżeń, przekaż sys.stderr do logging.StreamHandler:

import logging
import sys

logger = logging.getLogger("google.ads.googleads.client")
logger.addHandler(logging.StreamHandler(sys.stderr))
logger.setLevel(logging.WARNING)

Poziomy logowania

Klient generuje logi na kilku poziomach ważności, a loggera możesz skonfigurować tak, aby wyświetlał niektóre lub wszystkie z tych informacji:

Poziom Żądanie zostało zrealizowane Nieudane żądanie
DEBUG Szczegółowy dziennik z kompletnymi obiektami żądań i odpowiedzi w formacie JSON. Szczegółowy dziennik z kompletnymi obiektami żądań i wyjątków w formacie JSON.
INFO Krótkie podsumowanie z określonymi polami żądania i odpowiedzi. Szczegółowy dziennik z kompletnymi obiektami żądań i wyjątków w formacie JSON.
WARNING Brak Krótkie podsumowanie z konkretnymi informacjami o żądaniu, stanem wyjątku i komunikatem o błędzie.

Platforma logowania w Pythonie ignoruje komunikaty logu, które są mniej poważne niż skonfigurowany poziom. Ustawienie poziomu na WARNING powoduje wyświetlanie w tabeli tylko zwięzłych komunikatów o nieudanych żądaniach, a ustawienie poziomu na DEBUG powoduje wyświetlanie wszystkich typów logów.

Zapisywanie w pliku

Logi możesz zapisywać w pliku programowo w Pythonie lub przekierowując dane wyjściowe z wiersza poleceń.

Zapisywanie logów w pliku w Pythonie

Aby zapisywać logi bezpośrednio w pliku z poziomu Pythona, dołącz logging.FileHandler do rejestratora klienta:

import logging

logger = logging.getLogger("google.ads.googleads.client")
file_handler = logging.FileHandler("google_ads.log")
logger.addHandler(file_handler)
logger.setLevel(logging.INFO)

Przekierowywanie danych wyjściowych za pomocą powłoki

Uruchamiając przykładowe skrypty, takie jak get_campaigns.py, z wiersza poleceń, możesz przekierować dane wyjściowe dziennika konsoli do pliku za pomocą powłoki systemu operacyjnego.

Aby zapisać standardowe dane wyjściowe w pliku (zastępując istniejący plik):

python get_campaigns.py -c $CUSTOMER_ID > campaign_logs.txt

Aby dołączyć standardowe dane wyjściowe do istniejącego pliku:

python get_campaigns.py -c $CUSTOMER_ID >> campaign_logs.txt

Aby zapisać zarówno standardowe dane wyjściowe, jak i standardowe dane o błędach (w przypadku błędów i ostrzeżeń) w tym samym pliku:

python get_campaigns.py -c $CUSTOMER_ID > all_logs.txt 2>&1

W Bash 4 lub nowszym:

python get_campaigns.py -c $CUSTOMER_ID &> all_logs.txt

Niestandardowe przechwytywanie gRPC

Biblioteka klienta w Pythonie używa interceptorów gRPC do uzyskiwania dostępu do szczegółów żądań i odpowiedzi oraz ich rejestrowania. Możesz skonfigurować własne logowanie niestandardowe, tworząc przechwytujący gRPC z niestandardową logiką. Więcej informacji i przykład niestandardowego interfejsu przechwytującego logowanie znajdziesz w przewodniku po logowaniu.