التسجيل

يمكن إعداد المكتبة لتسجيل التفاعلات مع 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، تأكد من الأسطر أعلاه قبل تهيئة العميل.

مستويات السجلّ

ينشئ العميل سجلات على بضعة مستويات مختلفة ويمكنك تعيين لمشاهدة بعض أو كل ما يلي:

نظرًا لأن إطار تسجيل بايثون يتجاهل رسائل السجل الأقل خطورة عن المستوى الذي تم إعداده، يعني الضبط على WARNING أنك سترى فقط رسائل موجزة تتعلق بالطلبات التي أخفقت، ولكن التعيين على DEBUG يعني ستشاهد جميع أنواع السجلات المحتملة في الجدول أعلاه.

التسجيل إلى الملف

يمكنك بسهولة توجيه رسائل السجل إلى أحد الملفات، على سبيل المثال، عند تشغيل مثال على get_campaigns::

python get_campaigns.py -c $CLIENT_ID 2> example.log

اعتراضات التسجيل

تستخدم مكتبة برامج Python لغة gRPC أدوات الاعتراض للدخول إلى الطلب وتسجيله وتفاصيل الرد. يمكنك إعداد تسجيل مخصّص من خلال إنشاء gRPC. أداة اعتراض ذات منطق مخصص. يمكنك الاطّلاع على صفحة التسجيل الدليل للحصول على مزيد من التفاصيل ومثال على أداة اعتراض تسجيل مخصصة.