Ведение журнала

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

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

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

Тип журнала Имя журнала Уровень успеха Уровень отказа
КРАТКОЕ СОДЕРЖАНИЕ Google.Реклама.GoogleРеклама.Сводка ИНФОРМАЦИЯ ПРЕДУПРЕЖДАТЬ
ДЕТАЛИ Google.Ads.GoogleAds.Подробнее ОТЛАЖИВАТЬ ИНФОРМАЦИЯ

В случае частичных сбоев сведения о частичном сбое будут регистрироваться в 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 для еще большего контроля над регистрацией запросов.