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.