Aktifkan logging

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

Level log

Library mencatat peristiwa pada berbagai tingkat log, bergantung pada hasil permintaan API:

Jenis peristiwa Tingkat 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.

Pencatat log default

Siapkan pencatat 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

Pencatat log kustom

Anda juga dapat menentukan instance Ruby Logger 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)