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