核心功能
openclaw-google-ads 是一个面向 OpenClaw 代理的 Google Ads 数据访问工具，通过官方 Google Ads API 实现广告账户的自动化数据拉取与管理。核心能力包括：
- 账户级数据访问：支持 Manager Account (MCC) 与单一客户账户查询
- 标准指标获取：曝光量、点击数、转化数、花费等核心投放数据
- GAQL 自定义查询：通过 Google Ads Query Language 灵活提取特定维度数据
- 预置脚本集： campaigns 列表、账户摘要、自定义查询等即用脚本
显著优势
1. 官方 API 背书：基于 Google Ads API，数据源权威性高，字段与官方控制台保持一致
2. OAuth2 安全认证：采用标准 OAuth2 流程，支持 refresh token 长期授权，避免频繁登录
3. 灵活查询能力：GAQL 支持多表关联、时间分段、复杂过滤，满足精细化分析需求
4. 环境变量隔离：凭证与代码分离，符合安全开发规范
局限性与注意事项
- 权限门槛高：需 Google Ads 账户具备 API 访问权限（Basic Access），申请审核周期约 1-2 周
- OAuth 配置复杂：需 Google Cloud 项目、启用 API、创建 OAuth 凭证、配置 scope 等多步骤
- 速率限制存在：API 存在每日调用配额，大规模数据提取需分页处理
- 无实时数据：数据存在延迟（通常数小时），非毫秒级实时
适用人群
- 数字营销团队：需批量导出多账户投放数据制作周报/月报
- 广告数据分析师：通过 GAQL 进行自定义归因分析、漏斗分析
- MarTech 开发者：构建内部广告投放监控 Dashboard 或自动化报警系统
- 电商运营：监控购物广告转化成本与 ROAS 趋势
常规风险提示
- 凭证泄露风险：
GOOGLE_ADS_DEVELOPER_TOKEN与 OAuth 凭证若泄露，可能导致账户数据被恶意访问；务必使用环境变量或密钥管理服务，禁止硬编码 - 数据权限边界：OAuth scope
adwords授予对广告账户的读写权限，需明确告知用户授权范围 - 合规使用：Google Ads API 受 Google API 服务条款约束，禁止用于抓取竞争对手数据等违规用途
- Token 过期管理：refresh token 可能因用户取消授权或密码更改失效，需实现失效重认证机制