日志记录

通过 Google Ads API 发出的请求、收到的响应和生成的摘要消息可以使用您自己的自定义记录器或 Perl 客户端库中的默认记录器进行记录。

日志级别

该库会将不同类型的事件记录到不同的日志级别。如果 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 类的方法，以便更好地控制请求的记录方式。