核心用法
该技能通过 Maton 代理层封装 Google Ads API，提供 CLI、Python、JavaScript 等多语言接入方式。用户需先通过 Maton 账户获取 API Key 并完成 OAuth 授权，创建连接后即可对指定客户 ID（Customer ID）执行 GAQL 查询。支持的操作包括：列出可访问账户、搜索广告系列/广告组/关键词、获取搜索词报告、查询效果指标（曝光、点击、转化、花费等），以及通过 searchStream 处理大规模数据。
CLI 示例：maton google-ads query -c 1234567890 --resource campaign --fields 'campaign.id, campaign.status' 或直接使用 GAQL 语句。对于 MCC（经理账户）下的子账户，需通过 --login-customer-id 指定经理账户 ID。
显著优点
1. 托管 OAuth：无需自行申请 Google Ads API 开发者令牌或处理 OAuth 2.0 刷新令牌，降低接入门槛。
2. 多语言 SDK 与 CLI：提供统一的 CLI 工具及 Python/JS 代码示例，快速集成。
3. 完整 GAQL 支持：可直接使用 Google Ads Query Language 进行复杂查询，包括时间分段、过滤、排序、LIMIT 等。
4. 自动分页与流式查询：内置 --paginate 和 searchStream 支持，优化大数据量场景。
5. 字段级权限控制：写入操作需显式用户确认，降低误操作风险。
潜在缺点或局限性
1. 速率限制：每账户 10 req/sec，高频场景需自行实现退避重试。
2. Maton 依赖：所有流量经过 Maton 代理，存在单点依赖；若 Maton 服务不可用则无法访问。
3. 微单位换算：金额字段返回 micros（百万分之一），需额外转换。
4. MCC 复杂度：跨账户查询需正确配置 login-customer-id，易混淆客户 ID 与经理 ID。
5. 无原生写入覆盖：虽然支持写入，但需用户确认步骤，自动化批量修改场景效率受限。
适合人群
- 需要快速接入 Google Ads API 但不愿维护 OAuth 凭证的开发者
- 数据分析师需定期拉取广告效果报表进行 BI 分析
- 自动化广告投放工具开发者，需程序化查询账户结构
- 中小代理需同时管理多个客户账户，利用 MCC 结构简化权限
常规风险
- 凭证泄露：
MATON_API_KEY泄露可能导致账户数据被非法访问，需妥善保管环境变量。 - OAuth 范围风险：授权后 Maton 可访问所连接 Google Ads 账户的全部数据，需定期审计活跃连接。
- 误操作风险：虽有写入确认，但 GAQL 的
REMOVE操作不可逆，建议生产环境使用只读连接。 - 第三方合规：数据经过 Maton 服务器，需确认符合 GDPR/广告数据处理协议。