启用日志记录

您可以使用 Ruby 客户端库中的默认记录器或您自己的自定义 Ruby 记录器，记录发送到 Google Ads API 的请求、响应和摘要消息。如果未提供任何日志记录配置，则默认停用日志记录功能。

日志级别

该库会根据 API 请求的结果，以不同的日志级别记录事件：

事件类型 摘要日志级别 完整请求和响应日志级别
成功的 API 响应 INFO DEBUG
API 错误 WARN INFO
部分失败 无 DEBUG（部分失败详情）

配置

您可以在 google_ads_config.rb 配置文件中或在运行时以编程方式配置日志记录。

默认记录器

通过在 google_ads_config.rb 文件中指定 log_level 和 log_target 字段来设置默认日志记录器：

Google::Ads::GoogleAds::Config.new do |c|
  # Valid levels: 'DEBUG', 'INFO', 'WARN', 'ERROR', 'FATAL'
  c.log_level = 'INFO'

  # Output destination, such as STDOUT, STDERR, or a file path
  c.log_target = STDOUT
end

自定义记录器

您还可以使用 logger 字段指定自己的自定义 Ruby Logger 实例。如果您指定了 logger，则系统会忽略 log_level 和 log_target：

require 'logger'

# In google_ads_config.rb:
Google::Ads::GoogleAds::Config.new do |c|
  c.logger = Logger.new('log/google_ads.log')
end

您还可以在使用 client.logger= 实例化客户端后分配自定义记录器。请注意，此设置仅对在设置 client.logger 后提取 (client.service.<name>) 的服务客户端生效：

require 'logger'

client = Google::Ads::GoogleAds::GoogleAdsClient.new
client.logger = Logger.new(STDOUT)