跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 Google Ads,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
摘要
Google 已于 2026 年 9 月 9 日停用 Google Ads API 开发者令牌。访问权限现在归属于你的 Google Cloud 项目:Test、Explorer、Basic 和 Standard 级别及其获取方式。
试试这样问
Google Ads 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
开发者令牌已经取消
简短答案: 自 2026 年 9 月 9 日 起,Google Ads API 不再需要开发者令牌。访问权限授予你的 Google Cloud 项目,分为四个访问级别(Test、Explorer、Basic、Standard),你可以在 Cloud 控制台中该项目的 Google Ads API 页面上申请。使用 API 也不再需要 Google Ads 经理(MCC)账号。你仍然可以发送 developer-token header,但 Google 会忽略它。
Google 的 开发者令牌页面 说得很直接:开发者令牌已于 2026 年 9 月 9 日停用,现有的访问级别已根据近期的 API 活动转移到 Cloud 项目。通过经理账号的 API 中心提交的申请将不再处理。
变化前后对比
| 2026 年 9 月之前 | 2026 年 9 月 9 日起 | |
|---|---|---|
| 用什么识别你的应用 | 来自经理账号 API 中心的开发者令牌 | 你的 Google Cloud 项目 |
| 经理(MCC)账号 | 获取令牌时必需 | 仅在管理多个账号时需要 |
| 在哪里申请 | Google Ads 中的 API 中心 | Cloud 控制台中的 Google Ads API 页面 |
developer-token header | 每次调用都必需 | 可选,会被忽略 |
| 配额 | 按开发者令牌计算 | 按 Cloud 项目计算 |
| OAuth | 用户凭据 | 不变:用户凭据,scope 为 adwords |
访问级别
| 级别 | 账号 | 每日操作次数 | 获取方式 |
|---|---|---|---|
| Test | 仅测试账号 | 15,000 | 新项目的默认级别 |
| Explorer | 测试账号和正式账号 | 正式账号 2,880,测试账号 15,000 | 在 Cloud 控制台申请;通常自动授予,无需品牌验证 |
| Basic | 测试账号和正式账号 | 15,000 | 完成项目品牌验证后申请;几分钟内完成审核 |
| Standard | 测试账号和正式账号 | 无限制(适用各服务的速率限制) | 申请;人工审核约 10 个工作日 |
在 Test 访问级别下,调用真实账号会失败并返回 CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION。这是变更后大多数人最先遇到的错误:项目正常,OAuth 也正常,但级别仍然是 Test。
Explorer 足以读取你自己的账号或少量客户账号。像“上个月广告系列效果”这样的报告算一次操作;AI agent 回答一个问题通常需要两到八次。
现在如何获取访问权限
- 打开 console.cloud.google.com,选择或创建一个项目,然后进入 APIs & Services → Library,启用 Google Ads API。
- 打开项目的 Google Ads API 页面。页面上会显示当前的访问级别;展开 Upgrade access level,申请 Explorer(或在品牌验证后申请 Basic)。
- 在 APIs & Services → Credentials 下创建一个 OAuth client ID,并将 OAuth consent screen 设为 In production(在 Testing 模式下,refresh token 会在 7 天后过期)。
- 用一个有权访问广告账号的 Google 用户进行授权。
adwords是唯一的 scope,而且它并非只读,所以只给该用户所需的角色,不要多给。
这对现有工具意味着什么
2026 年 9 月之前编写的脚本、CLI 和 MCP 服务器通常会要求提供开发者令牌和经理账号。只要它们同时发送来自有访问权限项目的 OAuth 凭据,就仍然可以正常工作,因为令牌 header 会被忽略。但它们的设置说明现在会引导用户去完成已经不存在的步骤,新用户即使在 API 中心创建了令牌,也得不到任何用处。
你自己的设置中需要更新的地方:
- 不要再要求
GOOGLE_ADS_DEVELOPER_TOKEN;保留 OAuth 客户端 ID、密钥和 refresh token。 - 确保 OAuth 客户端属于一个拥有 Explorer 或更高访问级别的 Cloud 项目。
- 仅在通过经理账号访问时保留
login-customer-id。 - 记住配额现在属于 Cloud 项目。共用同一个 OAuth 客户端的多个工具会共享配额。
在 Claude 或 ChatGPT 中使用
AnythingMCP 上的 Google Ads 连接器 就是为新模式构建的:它只要求提供 OAuth 客户端 ID 和密钥(以及可选的经理账号 ID),你在浏览器中授权一次,Claude、ChatGPT、Cursor 或 Gemini 就能读取你的广告系列、搜索字词、质量得分、预算和转化。它是只读的,也不需要开发者令牌。
FAQ
我的工具仍然要求开发者令牌,该填什么? 随便填什么都行,如果工具允许,也可以留空:Google 会忽略这个 header。关键在于 OAuth 客户端来自一个有访问权限的 Cloud 项目。
我还需要经理(MCC)账号吗? 只有在通过一个登录管理多个账号时才需要。对于你自己的账号,可以直接调用 API。
读取我自己的账号需要哪个访问级别? Explorer。Test 访问级别只能访问测试账号。
配额是按用户还是按项目计算? 按 Google Cloud 项目计算,采用滚动的 24 小时窗口。
哪里有相关文档? 在 Google 的 开发者令牌 和 访问级别 页面。
相关指南
这份指南对你有帮助吗?