您可以使用自己的自定义日志记录器或 Perl 客户端库中的默认日志记录器,记录向 Google Ads API 发出的请求、响应和摘要消息。
日志级别
该库会将不同类型的事件记录到不同的日志级别。如果 API 响应成功,摘要会记录在 INFO 中,完整的请求和响应会记录在 DEBUG 中。对于导致 API 错误的请求,摘要消息会记录在 WARN 中,完整的请求和响应会记录在 INFO 中。
| 日志类型 | 日志名称 | 成功级别 | 失败级别 |
|---|---|---|---|
| 摘要 | Google.Ads.GoogleAds.Summary | 信息 | WARN |
| 详细信息 | Google.Ads.GoogleAds.Detail | DEBUG | 信息 |
对于部分失败,部分失败详细信息会记录到 DEBUG 的 DETAIL 记录器中。
配置
客户端库使用自定义类来满足所有日志记录需求,并通过 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 类的方法,以便更好地控制请求的记录方式。