يمكن ضبط المكتبة لتسجيل التفاعلات مع Google Ads API بطرق مختلفة. يمكنك تسجيل الطلبات والردود التفصيلية، بالإضافة إلى الرسائل التلخيصية الأكثر إيجازًا. تتم إدارة هذه الإعدادات من خلال إعدادات مكتبة العميل. في ما يلي تفاصيل عن الأنواع المختلفة لخيارات الضبط المتاحة.
تستخدِم المكتبة إطار عمل التسجّل المدمج في Python، وتكون السجلات مُسجّلة في stderr تلقائيًا. في حال تضمين عنصر logging
المحدّد في الإعدادات، يتم تمريره مباشرةً إلى
logging.config.dictConfig
كdict.
يمكنك أيضًا ضبط التسجيل آليًا من خلال ضبط إعدادات تسجيل قبل بدء تشغيل العميل. يمكنك استرداد مثيل العميل logger وضبطه باستخدام المثال التالي:
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 باستخدام منطق مخصّص. اطّلِع على دليل تسجيل البيانات لمزيد من التفاصيل ومثال على أداة اعتراض تسجيل بيانات مخصّصة.