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 in diversi livelli di log. In caso di risposta positiva dell'API, il riepilogo viene registrato in INFO, mentre 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 | WARN |
| DETTAGLIO | Google.Ads.GoogleAds.Detail | DEBUG | INFORMAZIONI |
Per gli errori parziali, i dettagli vengono registrati nel logger DETAIL in 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 dettaglio scrivono nei file nella 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.
Attiva o disattiva i log
Il logging può essere attivato o disattivato in modo programmatico utilizzando i seguenti metodi helper:
Attiva il logging per entrambi i logger (passa
1per impostare il livello suDEBUGin modo che vengano registrati i payload completi di richiesta e risposta 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 i metodi della classe GoogleAdsLogger direttamente per un controllo ancora maggiore sul modo in cui vengono registrate le richieste.