日志记录

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