רישום
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
אפשר לרשום ביומן את הבקשות, התגובות והודעות הסיכום שנשלחות אל Google Ads API באמצעות כלי רישום מותאם אישית משלכם או באמצעות כלי רישום ברירת המחדל בספריית הלקוח של Perl.
רמות יומן
הספרייה תתעד סוגים שונים של אירועים ברמות שונות של יומן. אם התגובה של ה-API תהיה מוצלחת, הסיכום יתועד ב-INFO, והבקשה והתגובות המלאות יתועדו ב-DEBUG. בבקשה שהובילה לשגיאת API, הודעת הסיכום תתועד ב-WARN והבקשה והתגובה המלאות יתועדו ב-INFO.
| סוג יומן הביקורת |
שם יומן הביקורת |
רמת ההצלחה |
רמת הכשל |
| סיכום |
Google.Ads.GoogleAds.Summary |
מידע |
WARN |
| פרטים |
Google.Ads.GoogleAds.Detail |
ניפוי באגים |
מידע |
במקרה של כשלים חלקיים, פרטי הכשל החלקי יתועדו ביומן בכתובת DEBUG.
תצורה
ספריית הלקוח משתמשת במחלקה מותאמת אישית לכל מטרות הרישום ביומן, והיא נחשפת דרך המודול GoogleAdsLogger. המחלק הזה מספק הגדרת ברירת מחדל שגם כלי הסיכום וגם כלי הרישום המפורט ירשמו לקבצים יחסיים בתיקייה logs מתחת לספרייה HOME.
אבל אפשר לבטל את הגדרות ברירת המחדל על ידי ציון קובץ log4perl.conf בתיקייה HOME.
אפשר להפעיל או להשבית את הרישום ביומן באמצעות השיטות הבאות:
הפעלת רישום ביומן עבור שני רכיבי ה-logger.
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 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-27 (שעון UTC)."],[[["\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."]]
