日志记录

该库可配置为在 Google Ads 中记录与 Google Ads API 的互动, 构建容器您可以记录详细的请求和响应,如 以及更为简洁的摘要消息这些设置由 客户端库配置。下面详细介绍了 不同类型的可用配置选项

该库使用 Python 的内置日志记录功能 Framework 和 Cloud Logging 默认记录到 stderrlogging 对象(如果包含) 会直接传递给 logging.config.dictConfigdict 的形式指定。

您还可以通过设置日志记录功能,以编程方式配置日志记录 配置。您可以使用 logger 实例,并使用以下示例对其进行配置:

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 协议来设置自己的自定义日志记录。 具有自定义逻辑的拦截器。请参阅日志记录 指南 了解详情以及自定义日志记录拦截器的示例。