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