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