Logging
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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 verrà registrato in INFO e la richiesta
e le risposte complete verranno registrate in DEBUG. In una richiesta che ha generato
un errore API, il messaggio di riepilogo verrà registrato in WARN e la richiesta
e la risposta complete verranno 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 dell'errore parziale verranno registrati 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
registrano i file relativi nella cartella logs della directory HOME.
Tuttavia, la configurazione predefinita può essere sostituita fornendo un file
log4perl.conf
nella directory HOME.
Il logging può essere abilitato/disabilitato utilizzando i seguenti metodi:
Consente di attivare la registrazione per entrambi i logger.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
Disattiva la registrazione del riepilogo.
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 sulla modalità di registrazione delle richieste.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-27 UTC.
[null,null,["Ultimo aggiornamento 2025-08-27 UTC."],[[["\u003cp\u003eThe Google Ads API client library for Perl allows logging of requests, responses, and summaries using a custom or default logger.\u003c/p\u003e\n"],["\u003cp\u003eLogging levels include \u003ccode\u003eINFO\u003c/code\u003e, \u003ccode\u003eDEBUG\u003c/code\u003e, and \u003ccode\u003eWARN\u003c/code\u003e, used to categorize different event types like successes, failures, and partial failures.\u003c/p\u003e\n"],["\u003cp\u003eThe default logger configuration saves logs to the \u003ccode\u003elogs\u003c/code\u003e folder in your home directory, which can be customized by providing a \u003ccode\u003elog4perl.conf\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eLogging can be controlled through the \u003ccode\u003eGoogleAdsLogger\u003c/code\u003e module, allowing for enabling/disabling logging or more advanced customization.\u003c/p\u003e\n"]]],[],null,["# Logging\n\nRequests, responses, and summary messages made to the Google Ads API can be\nlogged with your own custom logger or the default logger in the client library\nfor Perl.\n\nLog Levels\n----------\n\nThe library will log different types of events to different log levels. On a\nsuccessful API response, the summary will be logged at `INFO`, and the full\nrequest and responses will be logged at `DEBUG`. On a request that resulted in\nan API error, the summary message will be logged at `WARN` and the full request\nand response will be logged at `INFO`.\n\n| Log type | Log name | Success level | Failure level |\n|----------|------------------------------|---------------|---------------|\n| SUMMARY | Google.Ads.GoogleAds.Summary | INFO | WARN |\n| DETAIL | Google.Ads.GoogleAds.Detail | DEBUG | INFO |\n\nFor partial failures, the partial failure details will be logged at `DEBUG`.\n\nConfiguration\n-------------\n\nThe client library uses a custom class for all logging purposes and is exposed\nthrough the [GoogleAdsLogger](https://github.com/googleads/google-ads-perl/blob/HEAD/lib/Google/Ads/GoogleAds/Logging/GoogleAdsLogger.pm)\nmodule. This class provides a default configuration that both summary and detail\nloggers will log to relative files in the `logs` folder under your `HOME` directory.\nBut the default configuration can be overridden by providing a\n[log4perl.conf](https://github.com/googleads/google-ads-perl/blob/HEAD/log4perl.conf)\nfile in your `HOME` directory.\n\nLogging can be enabled/disabled using the following methods:\n\n- Enables logging for both loggers.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();\n\n- Disables the summary logging.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();\n\n- Disables the detail logging.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();\n\nYou can use the methods of the `GoogleAdsLogger` class directly for even more\ncontrol over how requests are logged."]]
