您可以使用自己的自定义记录器或 Perl 客户端库中的默认记录器,记录对 Google Ads API 发出的请求、响应和摘要消息。
日志级别
该库会将不同类型的事件记录到不同的日志级别。对于成功的 API 响应,摘要会记录在 INFO 级别,完整请求和响应会记录在
DEBUG 级别。对于导致 API 错误的请求,摘要消息会记录在 WARN 级别,完整请求和响应会记录在 INFO 级别。
| 日志类型 | 日志名称 | 成功级别 | 失败级别 |
|---|---|---|---|
| 摘要 | Google.Ads.GoogleAds.Summary | INFO | WARN |
| 详细信息 | Google.Ads.GoogleAds.Detail | DEBUG | INFO |
对于部分失败,部分失败详细信息会记录到 DETAIL 记录器,级别为 DEBUG。
配置
客户端库使用自定义类进行所有日志记录,并通过
GoogleAdsLogger模块公开。此类提供默认配置,其中摘要和详细信息记录器都会写入 HOME 目录下的 logs 文件夹中的文件。
自定义 Log4perl 配置
您可以通过在 HOME 目录中提供自定义
log4perl.conf 文件,或者在发出 API
调用之前直接在应用中
初始化 Log::Log4perl,来替换默认配置。
启用或停用日志
您可以使用以下帮助程序方法以编程方式启用或停用日志记录:
为两个记录器启用日志记录(传递
1以将级别设置为DEBUG,以便为成功的调用记录完整的请求和响应载荷):use Google::Ads::GoogleAds::Logging::GoogleAdsLogger; Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);停用所有日志记录:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();停用摘要日志记录:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();停用详细信息日志记录:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
您可以直接使用 GoogleAdsLogger 类的方法,以便更好地控制请求的记录方式。