核心用法
Google Ads Skill 通过 Maton 网关代理访问 Google Ads API，提供托管式 OAuth 认证，用户只需持有 Maton API Key 即可调用完整的 Google Ads API 功能。核心操作包括：
1. 连接管理：通过 ctrl.maton.ai 管理 OAuth 授权连接，支持创建、查询、删除连接状态
2. 客户发现：调用 customers:listAccessibleCustomers 获取可访问的 Google Ads 账号 ID
3. 数据查询：使用 GAQL (Google Ads Query Language) 查询广告系列、广告组、关键词、效果指标等
4. 流式查询：searchStream 端点支持大数据集流式返回
典型工作流：获取 API Key → 创建连接并完成 OAuth 授权 → 列出客户 ID → 执行 GAQL 查询获取广告数据。
显著优点
- 零配置 OAuth：无需注册 Google Cloud 项目、配置 OAuth 同意屏幕或管理 refresh token，Maton 托管全部认证流程
- 原生 API 透传：网关直接代理到
googleads.googleapis.com，支持 v23 版本完整功能，非封装式 SDK - 多账户支持：通过
Maton-Connection头部可在同一 API Key 下管理多个 Google Ads 账户连接 - 即插即用：提供 Python、JavaScript、bash 等多语言代码示例，5 分钟完成首次调用
潜在缺点与局限性
- 第三方依赖：所有流量经过 Maton 网关 (
gateway.maton.ai)，存在单点故障和服务可用性风险 - 速率限制：明确标注 10 req/sec 每账户的硬限制，大规模数据拉取需配合 searchStream 并自行实现分页/流控
- 数据延迟：网关层可能引入额外网络跳数和缓存层，实时性要求极高的场景需验证实际延迟
- 费用不透明：文档未说明 Maton 平台自身的计费模式（是否按调用量、按月费或免费）
- 权限边界：OAuth 授权范围由 Maton 应用预设，用户无法自定义 scope，可能面临最小权限原则冲突
- 货币单位陷阱：金额字段统一使用 micros（百万分之一），需手动除以 1,000,000 转换，易引发财务计算错误
适合人群
- 需要快速接入 Google Ads 数据但不愿投入 OAuth 开发成本的营销技术团队
- 构建内部报表、BI 看板、自动化优化脚本的数据工程师
- 代理公司（Agency）管理多客户 Google Ads 账户的技术集成场景
- 初创公司或中小团队缺乏专职 Google Cloud/DevOps 人力的情况
常规风险
| 风险类别 | 具体说明 |
|---------|---------|
| **供应链安全** | Maton 作为中间人可完全解密并查看所有 API 请求与响应，存在数据窥探和泄露风险 |
| **密钥管理** | `MATON_API_KEY` 一旦泄露，攻击者可访问绑定的所有 Google Ads 账户，需严格遵循环境变量或密钥管理服务存储 |
| **合规隐患** | 广告数据可能包含 PII 或敏感商业信息，流经 Maton 网关需确认其 SOC2、GDPR 等合规认证状态 |
| **授权回收** | Google Ads OAuth refresh token 可能因用户撤销授权或 Google 安全策略变更而失效，需建立连接状态监控 |
| **成本失控** | Google Ads API 本身存在每日操作限制（Operation Limits），高频查询可能触发 Google 侧限流或额外费用 |