کتابخانه را می توان برای ثبت تعاملات با Google Ads API به روش های مختلف پیکربندی کرد. می توانید درخواست ها و پاسخ های دقیق و همچنین پیام های خلاصه تر را ثبت کنید. این تنظیمات توسط پیکربندی کتابخانه مشتری مدیریت می شود. در زیر جزئیات مربوط به انواع مختلف گزینه های پیکربندی موجود است.
این کتابخانه از چارچوب لاگ داخلی پایتون استفاده می‌کند و به‌طور پیش‌فرض در stderr لاگ می‌کند. در صورت وجود، شی logging تعریف‌شده در پیکربندی شما مستقیماً به عنوان dict به logging.config.dictConfig ارسال می‌شود.
شما همچنین می توانید با تنظیم یک پیکربندی ورود به سیستم قبل از مقداردهی اولیه مشتری، ورود به سیستم را به صورت برنامه ای پیکربندی کنید. شما می توانید نمونه Client Logger را بازیابی کرده و با مثال زیر پیکربندی کنید:
import logging
logging.basicConfig(level=logging.INFO, format='[%(asctime)s - %(levelname)s] %(message).5000s')
logging.getLogger('google.ads.googleads.client').setLevel(logging.INFO)
توجه داشته باشید که Client Logger زمانی پیکربندی می شود که کلاینت مقداردهی اولیه شود. هر گونه تغییر بعدی در پیکربندی گزارش نادیده گرفته خواهد شد. به منظور لغو برنامه‌ریزی پیکربندی گزارش‌گیری در فایل YAML، حتماً خطوط فوق را قبل از مقداردهی اولیه کلاینت فراخوانی کنید.
سطوح ورود به سیستم
کلاینت گزارش‌ها را در چند سطح مختلف تولید می‌کند و می‌توانید پیکربندی خود را برای دیدن برخی یا همه موارد زیر تنظیم کنید:
| سطح | درخواست موفقیت آمیز | درخواست ناموفق |
|---|---|---|
DEBUG | گزارش دقیق با اشیاء درخواست و پاسخ کامل به عنوان JSON. | گزارش تفصیلی با درخواست کامل و اشیاء استثنا به عنوان JSON. |
INFO | خلاصه ای مختصر با فیلدهای درخواست و پاسخ خاص. | گزارش تفصیلی با درخواست کامل و اشیاء استثنا به عنوان JSON. |
WARNING | هیچ کدام | خلاصه ای مختصر با اطلاعات درخواستی خاص، وضعیت استثنا و پیام. |
از آنجایی که چارچوب ورود به سیستم پایتون پیام‌های گزارشی را که شدیدتر از سطح پیکربندی شده هستند نادیده می‌گیرد، تنظیم روی WARNING به این معنی است که شما فقط پیام‌های مختصر مربوط به درخواست‌های ناموفق را خواهید دید، اما تنظیم روی DEBUG به این معنی است که همه انواع گزارش‌های ممکن را در جدول بالا مشاهده خواهید کرد.
ورود به فایل
شما به راحتی می توانید پیام های گزارش را به یک فایل انتقال دهید. به عنوان مثال، هنگام اجرای get_campaigns مثال::
python get_campaigns.py -c $CLIENT_ID 2> example.log
رهگیرهای ورود به سیستم
کتابخانه مشتری پایتون از رهگیرهای gRPC برای دسترسی و ثبت جزئیات درخواست و پاسخ استفاده می کند. شما می توانید ثبت سفارشی خود را با ایجاد یک رهگیر gRPC با منطق سفارشی تنظیم کنید. برای جزئیات بیشتر و مثالی از یک رهگیر ثبت سفارشی، به راهنمای ورود به سیستم مراجعه کنید.