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 API riuscita, il riepilogo viene registrato in INFO e la richiesta
e la risposta complete vengono registrate in DEBUG. In una richiesta che genera
un errore API, il messaggio di riepilogo viene registrato in WARN e la richiesta
e la risposta complete vengono registrate in INFO.
| Tipo di log | Nome log | Livello di successo | Livello di errore |
|---|---|---|---|
| RIEPILOGO | Google.Ads.GoogleAds.Summary | INFORMAZIONI | AVVISO |
| DETTAGLIO | Google.Ads.GoogleAds.Detail | DEBUG | INFORMAZIONI |
Per gli errori parziali, i dettagli vengono registrati nel logger DETAIL
all'indirizzo 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 dettagli scrivono nei file della cartella logs nella directory HOME.
Personalizza la configurazione di Log4perl
Puoi eseguire l'override della configurazione predefinita fornendo un file
log4perl.conf personalizzato nella directory HOME o inizializzando
Log::Log4perl direttamente nell'applicazione prima di effettuare chiamate API.
Attivare o disattivare i log
La registrazione può essere attivata o disattivata a livello di programmazione utilizzando i seguenti metodi helper:
Abilita il logging per entrambi i logger (trasmetti
1per impostare il livello suDEBUGin modo che i payload completi di richieste e risposte vengano registrati per le chiamate riuscite):use Google::Ads::GoogleAds::Logging::GoogleAdsLogger; Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);Disabilita tutto il logging:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();Disattiva il logging dei riepiloghi:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();Disabilita il logging dettagliato:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
Puoi utilizzare direttamente i metodi della classe GoogleAdsLogger per avere un controllo ancora maggiore
sulle modalità di registrazione delle richieste.