التسجيل

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

تستخدم المكتبة إطار تسجيل الدخول المدمج في لغة بايثون والسجلات في 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

أدوات اعتراض التسجيل

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