Запросы, ответы и сводные сообщения, отправленные в API Google Ads, можно регистрировать с помощью собственного пользовательского регистратора или регистратора по умолчанию в клиентской библиотеке для Perl.
Уровни журнала
Библиотека регистрирует различные типы событий на разных уровнях журнала. При успешном ответе API сводка будет записана в INFO
, а полный запрос и ответы — в DEBUG
. Если запрос привёл к ошибке API, сводка будет записана в WARN
, а полный запрос и ответы — в INFO
.
Тип журнала | Имя журнала | Уровень успеха | Уровень отказа |
---|---|---|---|
КРАТКОЕ СОДЕРЖАНИЕ | Google.Ads.GoogleAds.Summary | ИНФОРМАЦИЯ | ПРЕДУПРЕЖДАТЬ |
ДЕТАЛЬ | 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
для еще большего контроля над тем, как регистрируются запросы.