日志记录

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

日志级别

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

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

对于部分失败,部分失败详细信息会记录到 DEBUG 的 DETAIL 记录器中。

配置

客户端库使用自定义类来满足所有日志记录需求,并通过 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 类的方法,以便更好地控制请求的记录方式。