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

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

Логарифмические уровни

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

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

В случае частичных сбоев подробная информация о них записывается в лог DETAIL в DEBUG .

Конфигурация

Клиентская библиотека использует собственный класс для всех целей логирования, доступный через модуль GoogleAdsLogger . Этот класс предоставляет конфигурацию по умолчанию, при которой как сводные, так и подробные записи логов ведут в файлы в папке logs в вашем HOME каталоге.

Настройка конфигурации Log4perl

Вы можете переопределить конфигурацию по умолчанию, указав собственный файл log4perl.conf в каталоге HOME или инициализировав Log::Log4perl непосредственно в вашем приложении перед выполнением вызовов API.

Включить или отключить ведение журналов

Включение или отключение ведения журнала можно осуществлять программно с помощью следующих вспомогательных методов:

• Включите логирование для обоих логгеров (передайте 1 , чтобы установить уровень отладки ( DEBUG и регистрировать полные данные запроса и ответа для успешных вызовов):

  use Google::Ads::GoogleAds::Logging::GoogleAdsLogger;
  
  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);
  

• Отключить все ведение журналов:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();
  

• Отключить ведение сводной документации:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
  

• Отключить подробное логирование:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
  

Для еще большего контроля над тем, как регистрируются запросы, вы можете напрямую использовать методы класса GoogleAdsLogger .