Google Ads API 是一个通过托管 OAuth 认证访问 Google Ads 数据的网关服务，旨在简化开发者与 Google Ads 平台的数据交互流程。该工具将原生 Google Ads API 封装为统一的 RESTful 接口，自动处理身份验证、令牌注入和请求转发，使开发者无需直接管理复杂的 OAuth 流程和 Google 开发者令牌。所有请求都通过 `https://gateway.maton.ai/google-ads/{native-api-path}` 路径代理到 `googleads.googleapis.com`，并强制要求提供 Maton 平台的 API 密钥进行授权。用户可通过 Maton 控制台（https://ctrl.maton.ai）轻松创建和管理多个 Google Ads 账户的连接，支持多客户环境下的灵活切换。该服务特别适用于需要批量获取广告系列、广告组、关键词及其性能指标的应用场景，如数据分析仪表盘、自动化投放系统和跨平台管理工具。
核心功能特点
- 通过托管 OAuth 实现安全的 Google Ads 数据访问，自动完成身份验证流程
- 使用 GAQL（Google Ads Query Language）查询广告活动、广告组、关键词及效果指标
- 支持多 Google Ads 账户连接管理，可通过 Maton-Connection 头指定特定连接
- 统一代理 Google Ads 原生 API 端点，简化客户端集成复杂度
- 提供完整的错误状态码映射和速率限制说明（10 req/sec per account）
适用场景
该工具最适合需要与 Google Ads 数据进行深度集成的开发者和企业应用。例如，营销技术团队可以构建自定义的广告效果分析平台，实时抓取过去30天的点击、展示和转化数据，用于生成动态报表或优化决策支持系统。广告代理商也可利用此 API 开发客户账户管理工具，批量监控多个客户的广告活动状态，自动暂停低效投放或调整预算分配。对于 SaaS 服务商而言，将其嵌入产品功能中可为用户提供无缝的 Google Ads 数据接入体验，而无需让用户自行配置 OAuth。此外，在自动化测试或 CI/CD 流程中，该网关能快速验证广告账户结构是否符合规范，确保新创建的 campaign 或 ad group 处于正确状态。无论是构建内部 BI 工具还是面向客户的第三方应用，该服务都大幅降低了对接 Google Ads 的技术门槛。