日志记录
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
该库可配置为在 Google Ads 中记录与 Google Ads API 的互动,
构建容器您可以记录详细的请求和响应,如
以及更为简洁的摘要消息这些设置由
客户端库配置。下面详细介绍了
不同类型的可用配置选项
该库使用 Python 的内置日志记录功能
Framework 和 Cloud Logging 默认记录到 stderr
。logging
对象(如果包含)
会直接传递给
logging.config.dictConfig
以 dict
的形式指定。
您还可以通过设置日志记录功能,以编程方式配置日志记录
配置。您可以使用
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 协议来设置自己的自定义日志记录。
具有自定义逻辑的拦截器。请参阅日志记录
指南
了解详情以及自定义日志记录拦截器的示例。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-08-20。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u6700\u540e\u66f4\u65b0\u65f6\u95f4 (UTC)\uff1a2024-08-20\u3002"}
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2024-08-20。"]]