Library dapat dikonfigurasi untuk mencatat interaksi dengan Google Ads API ke dalam log melalui berbagai cara. Anda dapat mencatat permintaan dan respons yang mendetail ke dalam log, serta pesan ringkasan yang lebih ringkas. Setelan ini dikelola oleh konfigurasi library klien. Berikut adalah detail tentang berbagai jenis opsi konfigurasi yang tersedia.
Library ini menggunakan framework logging
bawaan Python dan log ke stderr
secara default. Jika disertakan, objek logging
yang ditentukan dalam konfigurasi Anda akan diteruskan langsung ke
logging.config.dictConfig
sebagai dict
.
Anda juga dapat mengonfigurasi logging secara terprogram dengan menetapkan konfigurasi logging sebelum menginisialisasi klien. Anda dapat mengambil instance logger klien dan mengonfigurasinya dengan contoh berikut:
import logging
logging.basicConfig(level=logging.INFO, format='[%(asctime)s - %(levelname)s] %(message).5000s')
logging.getLogger('google.ads.googleads.client').setLevel(logging.INFO)
Perhatikan bahwa logger klien dikonfigurasi saat klien diinisialisasi. Setiap perubahan berikutnya pada konfigurasi logging akan diabaikan. Untuk mengganti konfigurasi logging dalam file YAML secara terprogram, pastikan untuk memanggil baris di atas sebelum klien diinisialisasi.
Level log
Klien menghasilkan log pada beberapa level yang berbeda, dan Anda dapat menetapkan konfigurasi untuk melihat beberapa atau semua hal di bawah ini:
Tingkat | Permintaan Berhasil | Permintaan Gagal |
---|---|---|
DEBUG |
Log mendetail dengan objek permintaan dan respons lengkap sebagai JSON. | Log mendetail dengan objek permintaan dan pengecualian lengkap sebagai JSON. |
INFO |
Ringkasan singkat yang berisi kolom permintaan dan respons tertentu. | Log mendetail dengan objek permintaan dan pengecualian lengkap sebagai JSON. |
WARNING |
Tidak ada | Ringkasan dengan informasi permintaan tertentu, status pengecualian, dan pesan. |
Karena framework logging Python mengabaikan pesan log yang lebih ringan daripada level yang dikonfigurasi, menyetel ke WARNING
berarti Anda hanya akan melihat pesan ringkas yang terkait dengan permintaan yang gagal. Namun, menetapkan ke DEBUG
berarti Anda akan melihat semua kemungkinan jenis log dalam tabel di atas.
Logging ke file
Anda dapat dengan mudah menyalurkan pesan log ke file; misalnya, saat menjalankan contoh get_campaigns
:
python get_campaigns.py -c $CLIENT_ID 2> example.log
Mencatat interseptor
Library klien Python menggunakan interseptor gRPC untuk mengakses dan mencatat detail permintaan dan respons. Anda dapat menyiapkan logging kustom sendiri dengan membuat interseptor gRPC menggunakan logika kustom. Lihat Panduan logging untuk mengetahui detail selengkapnya dan contoh interseptor logging kustom.