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)