Google Ads
通过GAQL查询Google Ads广告数据
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Google Ads。 它的用途是：通过GAQL查询Google Ads广告数据 完整的 Skill 内容见：https://321skill.com/skills/google-ads-x/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“查询我的Google Ads账号中最近7天所有广告系列的名称、花费、展示次数和点击率，按花费降序排列”，它会自动生成GAQL语句，调用API并返回表格数据，方便你快速评估投放效果。
介绍
Google Ads Skill 提供了一个与 Google Ads API 直接集成的接口，内置托管 OAuth 认证流程，让 AI Agent 能够安全、便捷地访问你的广告账户数据。你可以使用 GAQL（Google Ads Query Language）灵活查询广告系列、广告组、关键词以及展示次数、点击率、转化率等核心性能指标，无需手动处理 API 认证或拼写复杂的请求。
使用方式非常简单：你只需用自然语言描述查询需求，AI Agent 会自动生成 GAQL 语句并调用 API 获取数据，返回结构化的结果。例如，你可以说“查询最近7天所有广告系列的点击和花费”，或者“找出过去30天转化率最高的10个关键词”。Skill 会自动处理 OAuth 令牌刷新和分页，确保数据完整。
这款 Skill 特别适合营销专员、电商运营和数据分析师，尤其是需要频繁查看广告效果、优化投放策略的用户。它可以直接嵌入到你的工作流中，比如定期生成广告日报、自动分析渠道 ROI、或监控预算消耗。如果你同时使用其他第三方应用，建议搭配 api-gateway skill 统一管理。
使用时请注意：你需要拥有 Google Ads 账户的管理员权限并完成 OAuth 授权；API 调用受到 Google Ads 配额限制，高频查询可能触发限流；GAQL 语法较 SQL 有差异，复杂查询建议先确认字段名称。此外，该 Skill 仅适用于 Google Ads 平台，其他广告平台请使用对应集成。
核心特点
内置托管 OAuth 认证流程，无需手动配置凭证；直接支持 GAQL 语法，可灵活定制查询维度与指标，比普通API封装更灵活。
注意事项
仅适用于 Google Ads 平台，且依赖 Google Ads API 的配额和权限限制，不适合非 Google 广告系统或离线数据分析。
常见问题
如何查询广告系列的花费和转化数据？
直接对AI说“查询最近30天所有广告系列的花费、转化次数和成本”，Skill会自动生成GAQL并返回结果。
是否需要先配置OAuth？
需要，首次使用时会引导你完成Google Ads账户的OAuth授权，后续由Skill自动管理令牌刷新。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/google-ads-x/raw/index.md 读取 Google Ads 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/google-ads-x/raw/index.md（查看排版版本）