日志记录

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

日志级别

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

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

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

配置

客户端库将自定义类用于所有日志记录目的,并公开 (通过 GoogleAdsLogger) 模块。此类提供包含摘要和详情的默认配置 记录器将记录到 HOME 目录下 logs 文件夹中的相对文件。 不过,可以通过提供 log4perl.conf 文件(位于 HOME 目录中)。

您可以通过以下方法启用/停用日志记录功能:

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

    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 类的方法 控制请求的记录方式。