التسجيل
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكن تسجيل الطلبات والردود والرسائل التلخيصية التي يتم إرسالها إلى Google Ads API
من خلال المسجِّل المخصّص الخاص بك أو إلى مسجِّل تلقائي في مكتبة Ruby.
مستويات السجلّات
وستسجّل المكتبة أنواعًا مختلفة من الأحداث على مستويات سجلّ مختلفة. وإذا كانت الاستجابة ناجحة من واجهة برمجة التطبيقات، سيتم تسجيل الملخص في INFO، وسيتم تسجيل الطلب والردود الكاملة في DEBUG. في حال كان هناك طلب يؤدي إلى حدوث خطأ في واجهة برمجة التطبيقات، سيتم تسجيل رسالة الملخص في WARN وسيتم تسجيل الطلب والاستجابة الكاملَين في INFO.
بالنسبة إلى حالات الفشل الجزئية، سيتم تسجيل تفاصيل الإخفاق الجزئي في DEBUG.
الإعدادات
يمكن ضبط المُسجّل كجزء من
google_ads_config.rb
عملية الضبط. يمكنك إعداد مسجِّل تلقائي من خلال تحديد الحقلَين log_level و
log_target، أو يمكنك تحديد المسجِّل الخاص بك بالكامل من خلال تحديد logger. في حال تحديد logger، سيتم
تجاهل log_level وlog_target.
يمكنك أيضًا تحديد مسجّلة بعد إنشاء مثيل العميل باستخدام client.logger=.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Google Ads API Ruby library allows logging of requests, responses, and summaries to custom or default loggers.\u003c/p\u003e\n"],["\u003cp\u003eDifferent log levels are used for successful responses (\u003ccode\u003eINFO\u003c/code\u003e, \u003ccode\u003eDEBUG\u003c/code\u003e) and errors (\u003ccode\u003eWARN\u003c/code\u003e, \u003ccode\u003eINFO\u003c/code\u003e, \u003ccode\u003eDEBUG\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eLogging can be configured through the \u003ccode\u003egoogle_ads_config.rb\u003c/code\u003e file using \u003ccode\u003elog_level\u003c/code\u003e, \u003ccode\u003elog_target\u003c/code\u003e, or a custom \u003ccode\u003elogger\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAfter client instantiation, the logger can be specified using \u003ccode\u003eclient.logger=\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Logging\n\nRequests, responses, and summary messages made to the Google Ads API can be\nlogged to your own custom logger or a default logger in the Ruby library.\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\nFor partial failures, the partial failure details will be logged at `DEBUG`.\n\nConfiguration\n-------------\n\nThe logger can be configured as part of your\n[google_ads_config.rb](https://github.com/googleads/google-ads-ruby/blob/HEAD/google_ads_config.rb)\nconfiguration. You can set up a default logger by specifying the `log_level` and\n`log_target` fields, or you can specify your own logger entirely by specifying\n`logger`. If you specify `logger`, then `log_level` and `log_target` will be\nignored.\n\nYou can also specify a logger after instantiating the client using\n`client.logger=`."]]
