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)