日志记录

您可以使用自己的自定义日志记录器或 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 类的方法,进一步控制请求的记录方式。