Library ini dapat dikonfigurasi untuk mencatat interaksi dengan Google Ads API dengan berbagai cara. Anda dapat mencatat permintaan dan respons mendetail, 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 mencatat 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 melakukan inisialisasi 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 membuat log di beberapa tingkat yang berbeda dan Anda dapat menetapkan konfigurasi untuk melihat beberapa atau semua hal di bawah:
| Tingkat | Permintaan yang 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 ringkas dengan kolom permintaan dan respons tertentu. | Log mendetail dengan objek permintaan dan pengecualian lengkap sebagai JSON. |
WARNING |
Tidak ada | Ringkasan ringkas dengan informasi permintaan tertentu, status pengecualian, dan pesan. |
Karena framework logging Python mengabaikan pesan log yang kurang parah
daripada level yang dikonfigurasi, menetapkan ke WARNING berarti Anda hanya akan melihat
pesan ringkas yang terkait dengan permintaan yang gagal, tetapi menetapkan ke DEBUG berarti
Anda akan melihat semua kemungkinan jenis log dalam tabel di atas.
Membuat log 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
Interceptor logging
Library klien Python menggunakan interceptor gRPC untuk mengakses dan mencatat detail permintaan dan respons. Anda dapat menyiapkan logging kustom Anda sendiri dengan membuat pengendali gRPC dengan logika kustom. Lihat Panduan logging untuk mengetahui detail selengkapnya dan contoh interceptor logging kustom.