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