该库可配置为以多种方式记录与 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
日志记录拦截器
Python 客户端库使用 gRPC 拦截器来访问和记录请求和响应详情。您可以通过使用自定义逻辑创建 gRPC 拦截器来设置自己的自定义日志记录。如需了解详情并查看自定义日志记录拦截器示例,请参阅日志记录指南。