Logging

Library ini dapat dikonfigurasi untuk mencatat interaksi dengan Google Ads API ke dalam log dalam berbagai cara. Anda dapat mencatat permintaan dan respons mendetail, serta pesan ringkasan yang lebih ringkas. Setelan ini dikelola oleh konfigurasi library klien. Di bawah ini 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 secara terprogram dalam file YAML, pastikan untuk memanggil baris di atas sebelum klien diinisialisasi.

Level log

Klien menghasilkan log di 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 dengan kolom permintaan dan respons tertentu. Log mendetail dengan objek permintaan dan pengecualian lengkap sebagai JSON.
WARNING Tidak ada Ringkasan singkat dengan informasi permintaan spesifik, status pengecualian, dan pesan.

Karena framework logging Python mengabaikan pesan log yang lebih ringan daripada level yang dikonfigurasi, menetapkan ke WARNING berarti Anda hanya akan melihat pesan singkat yang terkait dengan permintaan yang gagal, tetapi menetapkan ke DEBUG berarti Anda akan melihat semua kemungkinan jenis log dalam tabel di atas.

Logging untuk file

Anda dapat dengan mudah menyalurkan pesan log ke sebuah file; misalnya, saat menjalankan contoh get_campaigns:

python get_campaigns.py -c $CLIENT_ID 2> example.log

Pencegat logging

Library klien Python menggunakan intersepsi gRPC untuk mengakses serta mencatat detail permintaan dan respons ke dalam log. Anda dapat menyiapkan logging kustom sendiri dengan membuat interseptor gRPC dengan logika kustom. Baca Panduan Logging untuk mengetahui detail selengkapnya dan contoh interseptor logging kustom.