يمكن تهيئة المكتبة لتسجيل التفاعلات مع إعلانات Google 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، تأكَّد من استدعاء السطور أعلاه قبل إعداد البرنامج.
مستويات السجلّ
ينشئ البرنامج سجلات على بضعة مستويات مختلفة، ويمكنك تعيين التهيئة لعرض بعض أو كل من ما يلي:
| المستوى | طلب ناجح | إخفاق الطلب |
|---|---|---|
DEBUG |
سجلّ مفصّل يحتوي على طلبات كاملة وكائنات استجابة بتنسيق JSON | سجلّ مفصل يحتوي على طلب كامل وكائنات استثناء مثل JSON. |
INFO |
ملخص موجز يحتوي على حقول معينة للطلبات والاستجابة. | سجلّ مفصل يحتوي على طلب كامل وكائنات استثناء مثل JSON. |
WARNING |
لا ينطبق | ملخص موجز يحتوي على معلومات طلب محددة وحالة الاستثناء والرسالة. |
نظرًا لأن إطار عمل تسجيل Python يتجاهل رسائل السجل الأقل شدة
من المستوى الذي تم إعداده، يعني الإعداد على WARNING أنك لن تشاهد سوى
الرسائل الموجزة ذات الصلة بالطلبات الفاشلة، ولكن ضبطها على DEBUG تعني
أنك سترى جميع أنواع السجلات المحتملة في الجدول أعلاه.
تسجيل الدخول إلى الملف
يمكنك بسهولة إرسال رسائل السجل إلى ملف، على سبيل المثال، عند تشغيل مثال get_campaigns:
python get_campaigns.py -c $CLIENT_ID 2> example.log
أدوات اعتراض قطع الأشجار
تستخدم مكتبة برامج Python أدوات اعتراض gRPC للوصول إلى تفاصيل الطلب والاستجابة وتسجيلها. يمكنك إعداد تسجيل مخصّص لك من خلال إنشاء أداة اعتراض gRPC باستخدام منطق مخصّص. اطّلِع على دليل التسجيل للحصول على مزيد من التفاصيل ومثال على أداة اعتراض التسجيل المُخصَّصة.