Library dapat dikonfigurasi untuk mencatat interaksi dengan Google Ads API di dengan berbagai cara. Anda dapat mencatat permintaan dan respons terperinci, sebagai 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 logging bawaan Python
dan log ke stderr secara default. Jika disertakan, objek logging
yang ditentukan dalam konfigurasi Anda diteruskan langsung ke
logging.config.dictConfig
sebagai dict.
Anda juga dapat mengonfigurasi logging secara terprogram dengan menyetel konfigurasi sebelum menginisialisasi klien. Anda dapat mengambil klien dan konfigurasikan 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. Apa saja perubahan berikutnya pada konfigurasi logging akan diabaikan. Untuk secara terprogram mengganti konfigurasi pencatatan log dalam file YAML, pastikan memanggil baris di atas sebelum klien diinisialisasi.
Level log
Klien menghasilkan log pada beberapa level yang berbeda dan Anda dapat mengatur 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 tidak terlalu serius
daripada level yang dikonfigurasi, menyetel ke WARNING berarti Anda hanya akan melihat
pesan ringkas yang terkait dengan permintaan yang gagal, tetapi menetapkan ke DEBUG berarti
Anda akan melihat semua jenis log
yang mungkin ada di tabel di atas.
Logging untuk 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
Pencegat logging
Library klien Python menggunakan gRPC interseptor untuk mengakses dan mencatat permintaan dan detail respons. Anda dapat menyiapkan logging kustom sendiri dengan membuat gRPC intersepsi dengan logika kustom. Lihat halaman Logging kami untuk detail lebih lanjut dan contoh pencegat logging kustom.