日志记录

您可以使用自己的自定义记录器或 Perl 客户端库中的默认记录器,记录对 Google Ads API 发出的请求、响应和摘要消息。

日志级别

该库会将不同类型的事件记录到不同的日志级别。对于成功的 API 响应,摘要会记录在 INFO 级别,完整请求和响应会记录在 DEBUG 级别。对于导致 API 错误的请求,摘要消息会记录在 WARN 级别,完整请求和响应会记录在 INFO 级别。

日志类型 日志名称 成功级别 失败级别
摘要 Google.Ads.GoogleAds.Summary INFO WARN
详细信息 Google.Ads.GoogleAds.Detail DEBUG INFO

对于部分失败,部分失败详细信息会记录到 DETAIL 记录器,级别为 DEBUG。

配置

客户端库使用自定义类进行所有日志记录,并通过 GoogleAdsLogger模块公开。此类提供默认配置,其中摘要和详细信息记录器都会写入 HOME 目录下的 logs 文件夹中的文件。

自定义 Log4perl 配置

您可以通过在 HOME 目录中提供自定义 log4perl.conf 文件,或者在发出 API 调用之前直接在应用中 初始化 Log::Log4perl,来替换默认配置。

启用或停用日志

您可以使用以下帮助程序方法以编程方式启用或停用日志记录:

  • 为两个记录器启用日志记录(传递 1 以将级别设置为 DEBUG,以便为成功的调用记录完整的请求和响应载荷):

    use Google::Ads::GoogleAds::Logging::GoogleAdsLogger;
    
    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);
    
  • 停用所有日志记录:

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();
    
  • 停用摘要日志记录:

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
    
  • 停用详细信息日志记录:

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

您可以直接使用 GoogleAdsLogger 类的方法,以便更好地控制请求的记录方式。