التسجيل
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكن تسجيل الطلبات والردود ورسائل الملخّصات التي يتم إرسالها إلى Google Ads API باستخدام أداة التسجيل المخصّصة أو أداة التسجيل التلقائية في مكتبة العميل للغة Perl.
مستويات السجلّ
ستسجّل المكتبة أنواعًا مختلفة من الأحداث في مستويات سجلّ مختلفة. عند تلقّي استجابة ناجحة من واجهة برمجة التطبيقات، سيتم تسجيل الملخّص في INFO، وسيتم تسجيل الطلب والاستجابات الكاملة في DEBUG. في الطلب الذي نتج عنه خطأ في واجهة برمجة التطبيقات، سيتم تسجيل رسالة الملخّص في WARN وسيتم تسجيل الطلب والردّ الكاملَين في INFO.
| نوع السجلّ |
اسم السجلّ |
مستوى النجاح |
مستوى الخطأ |
| الملخّص |
Google.Ads.GoogleAds.Summary |
معلومات |
WARN |
| التفصيل |
Google.Ads.GoogleAds.Detail |
تصحيح الأخطاء |
معلومات |
بالنسبة إلى حالات الفشل الجزئية، سيتم تسجيل تفاصيل الفشل الجزئي في DEBUG.
الإعداد
تستخدِم مكتبة البرنامج فئة مخصّصة لجميع أغراض التسجيل، ويتم عرضها من خلال وحدة GoogleAdsLogger. يوفر هذا الصف إعدادًا تلقائيًا سيتم تسجيله في ملفات نسبية في المجلد logs ضمن الدليل HOME لكل من مسجّلي الملخّص والتفاصيل.
ولكن يمكن إلغاء الإعداد التلقائي من خلال توفير ملف log4perl.conf في الدليل HOME.
يمكن تفعيل/إيقاف التسجيل باستخدام الطرق التالية:
تفعِّل هذه الوسيطة التسجيل لكلا مسجِّلَي البيانات.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
توقِف هذه الوسيطة تسجيل الملخّص.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
تؤدي إلى إيقاف التسجيل المفصّل.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
يمكنك استخدام طرق الفئة GoogleAdsLogger مباشرةً للتحكّم بشكل أكبر في كيفية تسجيل الطلبات.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Google Ads API client library for Perl allows logging of requests, responses, and summaries using a custom or default logger.\u003c/p\u003e\n"],["\u003cp\u003eLogging levels include \u003ccode\u003eINFO\u003c/code\u003e, \u003ccode\u003eDEBUG\u003c/code\u003e, and \u003ccode\u003eWARN\u003c/code\u003e, used to categorize different event types like successes, failures, and partial failures.\u003c/p\u003e\n"],["\u003cp\u003eThe default logger configuration saves logs to the \u003ccode\u003elogs\u003c/code\u003e folder in your home directory, which can be customized by providing a \u003ccode\u003elog4perl.conf\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eLogging can be controlled through the \u003ccode\u003eGoogleAdsLogger\u003c/code\u003e module, allowing for enabling/disabling logging or more advanced customization.\u003c/p\u003e\n"]]],[],null,["# Logging\n\nRequests, responses, and summary messages made to the Google Ads API can be\nlogged with your own custom logger or the default logger in the client library\nfor Perl.\n\nLog Levels\n----------\n\nThe library will log different types of events to different log levels. On a\nsuccessful API response, the summary will be logged at `INFO`, and the full\nrequest and responses will be logged at `DEBUG`. On a request that resulted in\nan API error, the summary message will be logged at `WARN` and the full request\nand response will be logged at `INFO`.\n\n| Log type | Log name | Success level | Failure level |\n|----------|------------------------------|---------------|---------------|\n| SUMMARY | Google.Ads.GoogleAds.Summary | INFO | WARN |\n| DETAIL | Google.Ads.GoogleAds.Detail | DEBUG | INFO |\n\nFor partial failures, the partial failure details will be logged at `DEBUG`.\n\nConfiguration\n-------------\n\nThe client library uses a custom class for all logging purposes and is exposed\nthrough the [GoogleAdsLogger](https://github.com/googleads/google-ads-perl/blob/HEAD/lib/Google/Ads/GoogleAds/Logging/GoogleAdsLogger.pm)\nmodule. This class provides a default configuration that both summary and detail\nloggers will log to relative files in the `logs` folder under your `HOME` directory.\nBut the default configuration can be overridden by providing a\n[log4perl.conf](https://github.com/googleads/google-ads-perl/blob/HEAD/log4perl.conf)\nfile in your `HOME` directory.\n\nLogging can be enabled/disabled using the following methods:\n\n- Enables logging for both loggers.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();\n\n- Disables the summary logging.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();\n\n- Disables the detail logging.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();\n\nYou can use the methods of the `GoogleAdsLogger` class directly for even more\ncontrol over how requests are logged."]]
