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