啟用記錄功能

您可以使用 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)