Le richieste, le risposte e i messaggi di riepilogo inviati all'API Google Ads possono essere registrati con il tuo logger personalizzato o con il logger predefinito nella libreria client per Perl.
Livelli di log
La libreria registra diversi tipi di eventi a diversi livelli di log. In caso di risposta dell'API riuscita, il riepilogo viene registrato a livello INFO, mentre la richiesta e la risposta complete vengono registrate a livello DEBUG. In caso di richiesta che genera un errore API, il messaggio di riepilogo viene registrato a livello WARN, mentre la richiesta e la risposta complete vengono registrate a livello INFO.
| Tipo di log | Nome log | Livello di successo | Livello di errore |
|---|---|---|---|
| RIEPILOGO | Google.Ads.GoogleAds.Summary | INFO | WARN |
| DETTAGLIO | Google.Ads.GoogleAds.Detail | DEBUG | INFO |
In caso di errori parziali, i dettagli vengono registrati nel logger DETAIL a livello DEBUG.
Configurazione
La libreria client utilizza una classe personalizzata per tutti gli scopi di logging ed è esposta
tramite il modulo GoogleAdsLogger. Questa classe fornisce una configurazione predefinita in cui i logger di riepilogo e di dettagli scrivono nei file della cartella logs nella directory HOME.
Personalizzare la configurazione di Log4perl
Puoi sostituire la configurazione predefinita fornendo un file personalizzato
log4perl.conf nella directory HOME o inizializzando
Log::Log4perl direttamente nella tua applicazione prima di effettuare chiamate API.
Attivare o disattivare i log
Il logging può essere attivato o disattivato a livello di programmazione utilizzando i seguenti metodi helper:
Attiva il logging per entrambi i logger (trasmetti
1per impostare il livello suDEBUGin modo che i payload completi di richiesta e risposta vengano registrati per le chiamate riuscite):use Google::Ads::GoogleAds::Logging::GoogleAdsLogger; Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);Disattiva tutti i log:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();Disattiva il logging di riepilogo:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();Disattiva il logging dei dettagli:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
Puoi utilizzare direttamente i metodi della classe GoogleAdsLogger per un controllo ancora maggiore sulla modalità di registrazione delle richieste.