日志记录

您还可以配置该库,以通过各种方式记录与 Google Ads API 的互动。您可以记录详细的请求和响应以及更简洁的摘要消息。这些设置由客户端库配置进行管理。下面详细介绍了可用的不同配置选项类型。

该库使用 Python 的内置日志记录框架,并会默认将日志记录到 stderr。如果包含,则配置中定义的 logging 对象会作为 dict 直接传递到 logging.config.dictConfig

您还可以在初始化客户端之前设置日志记录配置,从而以编程方式配置日志记录。您可以检索客户端日志记录器实例,并通过以下示例对其进行配置:

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

Logging 拦截器

Python 客户端库使用 gRPC 拦截器来访问并记录请求及响应详细信息。您可以通过使用自定义逻辑创建 gRPC 拦截器来设置自己的自定义日志记录。如需了解详情并查看自定义日志记录拦截器的示例,请参阅 Logging 指南