логирование

Запросы, ответы и сводные сообщения, отправленные в Google Ads API, можно регистрировать с помощью вашего собственного регистратора или регистратора по умолчанию в клиентской библиотеке для Perl.

Уровни журнала

Библиотека будет регистрировать различные типы событий на разных уровнях журнала. При успешном ответе API сводка будет зарегистрирована в INFO , а полный запрос и ответы будут зарегистрированы в DEBUG . Для запроса, который привел к ошибке API, сводное сообщение будет зарегистрировано в WARN , а полный запрос и ответ будут зарегистрированы в INFO .

Тип журнала Имя журнала Уровень успеха Уровень отказа
КРАТКОЕ СОДЕРЖАНИЕ Google.Ads.GoogleAds.Сводка ИНФОРМАЦИЯ ПРЕДУПРЕЖДАТЬ
ДЕТАЛИ 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 для еще большего контроля над регистрацией запросов.