Logging

Permintaan, respons, dan pesan ringkasan yang dibuat ke Google Ads API dapat dicatat ke dalam log dengan pencatat log kustom Anda sendiri atau pencatat log default di library klien untuk Perl.

Level log

Library mencatat berbagai jenis peristiwa ke berbagai level log. Pada respons API yang berhasil, ringkasan dicatat di INFO, dan permintaan serta respons lengkap dicatat di DEBUG. Pada permintaan yang menghasilkan error API, pesan ringkasan dicatat ke dalam log di WARN, sedangkan permintaan dan respons lengkap dicatat ke dalam log di INFO.

Untuk kegagalan parsial, detail kegagalan parsial dicatat ke logger DETAIL di DEBUG.

Konfigurasi

Library klien menggunakan class kustom untuk semua tujuan logging dan diekspos melalui modul GoogleAdsLogger. Class ini menyediakan konfigurasi default tempat pencatat log ringkasan dan detail menulis ke file di folder logs di bawah direktori HOME Anda.

Menyesuaikan konfigurasi Log4perl

Anda dapat mengganti konfigurasi default dengan menyediakan file log4perl.conf kustom di direktori HOME, atau dengan melakukan inisialisasi Log::Log4perl langsung di aplikasi sebelum melakukan panggilan API.

Mengaktifkan atau menonaktifkan log

Logging dapat diaktifkan atau dinonaktifkan secara terprogram menggunakan metode bantuan berikut:

• Aktifkan logging untuk kedua logger (terus 1 untuk menyetel tingkat ke DEBUG sehingga payload permintaan dan respons lengkap dicatat untuk panggilan yang berhasil):

  use Google::Ads::GoogleAds::Logging::GoogleAdsLogger;
  
  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);
  

• Nonaktifkan semua logging:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();
  

• Menonaktifkan logging ringkasan:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
  

• Nonaktifkan logging detail:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
  

Anda dapat menggunakan metode class GoogleAdsLogger secara langsung untuk mendapatkan kontrol yang lebih besar atas cara permintaan dicatat ke dalam log.