คุณสามารถกำหนดค่าไลบรารีให้บันทึกการโต้ตอบกับ Google Ads API ได้ใน ได้หลายวิธี คุณสามารถบันทึกคำขอและการตอบกลับโดยละเอียดเป็น และข้อความสรุปที่กระชับยิ่งขึ้น การตั้งค่าเหล่านี้จัดการโดย การกำหนดค่าไลบรารีของไคลเอ็นต์ ด้านล่างนี้คือรายละเอียดเกี่ยวกับ ตัวเลือกการกำหนดค่าประเภทต่างๆ ที่มีให้ใช้งาน
ไลบรารีใช้การบันทึกในตัวของ Python
ของเฟรมเวิร์กและบันทึกไปที่ stderr โดยค่าเริ่มต้น หากรวมไว้ ออบเจ็กต์ logging
ที่กำหนดไว้ในการกำหนดค่าของคุณจะถูกส่งไปที่
logging.config.dictConfig
ในฐานะ dict
คุณยังกำหนดค่าการบันทึกแบบเป็นโปรแกรมได้โดยการตั้งค่า การกำหนดค่าก่อนเริ่มต้นไคลเอ็นต์ คุณสามารถดึงข้อมูลไคลเอ็นต์ อินสแตนซ์ตัวบันทึก และกำหนดค่าด้วยตัวอย่างต่อไปนี้
import logging
logging.basicConfig(level=logging.INFO, format='[%(asctime)s - %(levelname)s] %(message).5000s')
logging.getLogger('google.ads.googleads.client').setLevel(logging.INFO)
โปรดทราบว่าระบบจะกำหนดค่าตัวบันทึกของไคลเอ็นต์เมื่อเริ่มต้นไคลเอ็นต์แล้ว ช่วง ระบบจะไม่สนใจการเปลี่ยนแปลงการกำหนดค่าการบันทึกในครั้งต่อๆ ไป หากต้องการ ลบล้างการกำหนดค่าการบันทึกในไฟล์ YAML แบบเป็นโปรแกรม เรียกใช้บรรทัดด้านบนก่อนที่ไคลเอ็นต์จะเริ่มต้น
ระดับบันทึก
ไคลเอ็นต์จะสร้างบันทึกในระดับต่างๆ 2-3 ระดับ และคุณสามารถตั้งค่า เพื่อดูตัวเลือกต่อไปนี้บางส่วนหรือทั้งหมด
| ระดับ | คำขอสำเร็จ | คำขอที่ไม่สำเร็จ |
|---|---|---|
DEBUG |
บันทึกโดยละเอียดที่มีออบเจ็กต์คำขอและการตอบกลับที่สมบูรณ์เป็น JSON | บันทึกโดยละเอียดพร้อมคำขอที่สมบูรณ์และออบเจ็กต์ข้อยกเว้นในรูปแบบ JSON |
INFO |
สรุปสั้นๆ ที่มีช่องคำขอและการตอบกลับที่เจาะจง | บันทึกโดยละเอียดพร้อมคำขอที่สมบูรณ์และออบเจ็กต์ข้อยกเว้นในรูปแบบ JSON |
WARNING |
ไม่มี | ข้อมูลสรุปที่กระชับซึ่งมีข้อมูลคำขอที่เฉพาะเจาะจง สถานะข้อยกเว้น และข้อความ |
เนื่องจากเฟรมเวิร์กการบันทึก Python จะไม่สนใจข้อความบันทึกที่มีระดับความรุนแรงน้อยกว่า
กว่าระดับที่กำหนดค่าไว้ การตั้งค่าเป็น WARNING หมายความว่าคุณจะเห็นเฉพาะ
ข้อความที่กระชับที่เกี่ยวข้องกับคำขอที่ล้มเหลว แต่การตั้งค่าเป็น DEBUG หมายความว่า
คุณจะเห็นบันทึกทุกประเภทที่เป็นไปได้ในตารางด้านบน
กำลังบันทึกไปยังไฟล์
คุณสามารถจับคู่ข้อความบันทึกไปยังไฟล์ได้อย่างง่ายดาย เช่น เมื่อเรียกใช้
ตัวอย่าง get_campaigns:
python get_campaigns.py -c $CLIENT_ID 2> example.log
ตัวดักจับการบันทึก
ไลบรารีของไคลเอ็นต์ Python ใช้ gRPC interceptors เพื่อเข้าถึงและบันทึกคำขอ และรายละเอียดของคำตอบ คุณตั้งค่าการบันทึกที่กำหนดเองได้โดยการสร้าง gRPC ด้วยตรรกะที่กำหนดเอง ดูการบันทึก คำแนะนำ เพื่อดูรายละเอียดเพิ่มเติมและตัวอย่างเครื่องมือดักจับการบันทึกที่กำหนดเอง