Logging
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Permintaan, respons, dan pesan ringkasan yang dibuat ke Google Ads API dapat dicatat dengan logger kustom Anda sendiri atau logger default di library klien untuk Perl.
Level Log
Library akan mencatat berbagai jenis peristiwa ke berbagai tingkat log. Pada respons API yang berhasil, ringkasan akan dicatat di INFO, dan permintaan serta respons lengkap akan dicatat di DEBUG. Pada permintaan yang menghasilkan
error API, pesan ringkasan akan dicatat di WARN dan permintaan
serta respons lengkap akan dicatat di INFO.
| Jenis log |
Nama log |
Tingkat keberhasilan |
Tingkat kegagalan |
| RINGKASAN |
Google.Ads.GoogleAds.Summary |
INFO |
WARN |
| DETAIL |
Google.Ads.GoogleAds.Detail |
DEBUG |
INFO |
Untuk kegagalan parsial, detail kegagalan parsial akan dicatat di DEBUG.
Konfigurasi
Library klien menggunakan class kustom untuk semua tujuan logging dan diekspos
melalui modul GoogleAdsLogger. Class ini menyediakan konfigurasi default yang akan mencatat logger ringkasan dan detail ke file relatif di folder logs dalam direktori HOME Anda.
Namun, konfigurasi default dapat diganti dengan menyediakan file
log4perl.conf
di direktori HOME Anda.
Logging dapat diaktifkan/dinonaktifkan menggunakan metode berikut:
Mengaktifkan logging untuk kedua logger.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
Menonaktifkan logging ringkasan.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
Menonaktifkan logging detail.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
Anda dapat menggunakan metode class GoogleAdsLogger secara langsung untuk mendapatkan kontrol yang lebih besar atas cara permintaan dicatat.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-27 UTC.
[null,null,["Terakhir diperbarui pada 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."]]
