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