Библиотеку можно настроить для регистрации взаимодействия с Google Ads API различными способами. Вы можете регистрировать подробные запросы и ответы, а также более краткие сводные сообщения. Эти параметры управляются конфигурацией клиентской библиотеки. Ниже приведены подробные сведения о различных типах доступных параметров конфигурации.
Библиотека использует встроенную среду ведения журналов Python и по умолчанию записывает данные в stderr . Если он включен, объект logging , определенный в вашей конфигурации, передается непосредственно в logging.config.dictConfig как dict .
Вы также можете настроить ведение журнала программно, задав конфигурацию ведения журнала перед инициализацией клиента. Вы можете получить экземпляр средства ведения журнала клиента и настроить его с помощью следующего примера:
import logging
logging.basicConfig(level=logging.INFO, format='[%(asctime)s - %(levelname)s] %(message).5000s')
logging.getLogger('google.ads.googleads.client').setLevel(logging.INFO)
Обратите внимание, что регистратор клиента настраивается при инициализации клиента. Любые последующие изменения в конфигурации журналирования будут игнорироваться. Чтобы программно переопределить конфигурацию ведения журнала в файле YAML, обязательно вызовите указанные выше строки до инициализации клиента.
Уровни журнала
Клиент генерирует журналы на нескольких разных уровнях, и вы можете настроить свою конфигурацию так, чтобы видеть некоторые или все из приведенного ниже:
| Уровень | Успешный запрос | Неудачный запрос |
|---|---|---|
DEBUG | Подробный журнал с полными объектами запросов и ответов в формате JSON. | Подробный журнал с полными объектами запросов и исключений в формате JSON. |
INFO | Краткое описание с конкретными полями запроса и ответа. | Подробный журнал с полными объектами запросов и исключений в формате JSON. |
WARNING | Никто | Краткое описание с конкретной информацией о запросе, состоянием исключения и сообщением. |
Поскольку среда ведения журналов Python игнорирует сообщения журнала, которые менее серьезны, чем настроенный уровень, установка значения WARNING означает, что вы увидите только краткие сообщения, связанные с неудачными запросами, а установка значения DEBUG означает, что вы увидите все возможные типы журналов в приведенной выше таблице.
Запись в файл
Вы можете легко передать сообщения журнала в файл; например, при запуске примера get_campaigns ::
python get_campaigns.py -c $CLIENT_ID 2> example.log
Перехватчики журналирования
Клиентская библиотека Python использует перехватчики gRPC для доступа и регистрации сведений о запросах и ответах. Вы можете настроить собственное ведение журнала, создав перехватчик gRPC с собственной логикой. Дополнительные сведения и пример пользовательского перехватчика журналирования см. в руководстве по ведению журнала .