Learn more about migrating to the Google Ads API by watching our latest webinar

Logging

Requests, responses, and summary messages made to the Google Ads API can be logged with your own custom logger or the default logger in the client library for Perl.

Log Levels

The library will log different types of events to different log levels. On a successful API response, the summary will be logged at INFO, and the full request and responses will be logged at DEBUG. On a request that resulted in an API error, the summary message will be logged at WARN and the full request and response will be logged at INFO.

Log type Log name Success level Failure level
SUMMARY Google.Ads.GoogleAds.Summary INFO WARN
DETAIL Google.Ads.GoogleAds.Detail DEBUG INFO

For partial failures, the partial failure details will be logged at DEBUG.

Configuration

The client library uses a custom class for all logging purposes and is exposed through the GoogleAdsLogger module. This class provides a default configuration that both summary and detail loggers will log to relative files in the logs folder under your HOME directory. But the default configuration can be overridden by providing a log4perl.conf file in your HOME directory.

Logging can be enabled/disabled using the following methods:

  • Enables logging for both loggers.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
    
  • Disables the summary logging.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
    
  • Disables the detail logging.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
    

You can use the methods of the GoogleAdsLogger class directly for even more control over how requests are logged.