Aktifkan logging

Anda dapat mencatat permintaan, respons, dan pesan ringkasan yang dikirim ke Google Ads API ke dalam log menggunakan logger default di library klien Ruby atau logger Ruby kustom Anda sendiri. Jika tidak ada konfigurasi logging yang diberikan, logging akan dinonaktifkan secara default.

Level log

Library mencatat peristiwa ke dalam log pada level log yang berbeda, bergantung pada hasil permintaan API:

Jenis peristiwa Level log ringkasan Tingkat log permintaan dan respons lengkap
Respons API yang berhasil INFO DEBUG
Error API WARN INFO
Kegagalan sebagian Tidak ada DEBUG (detail kegagalan sebagian)

Konfigurasi

Anda dapat mengonfigurasi logging di file konfigurasi google_ads_config.rb atau secara terprogram saat runtime.

Logger default

Siapkan logger default dengan menentukan kolom log_level dan log_target dalam file google_ads_config.rb Anda:

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 kustom

Anda juga dapat menentukan instance Logger Ruby kustom Anda sendiri menggunakan kolom logger. Jika Anda menentukan logger, log_level dan log_target akan diabaikan:

require 'logger'

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

Anda juga dapat menetapkan logger kustom setelah membuat instance klien menggunakan client.logger=. Perhatikan bahwa hal ini hanya berlaku pada klien layanan yang diambil (client.service.<name>) setelah client.logger ditetapkan:

require 'logger'

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