日志记录

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

日志级别

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

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

对于部分失败,部分失败详情将记录在 DEBUG 中。

配置

客户端库会使用自定义类来执行所有日志记录操作,并通过 GoogleAdsLogger 模块公开。此类提供了默认配置,即摘要和详细日志记录器都将记录到 HOME 目录下的 logs 文件夹中的相对文件。不过,您可以在 HOME 目录中提供 log4perl.conf 文件,以替换默认配置。

您可以使用以下方法启用/停用日志记录:

  • 为这两个日志记录器启用日志记录。

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

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

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

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