连接器指南阅读约 2 分钟17 个 MCP 工具7 种语言

无需开发者令牌的 Google Ads API:2026 年 9 月有哪些变化

Google 已于 2026 年 9 月 9 日停用 Google Ads API 开发者令牌。访问权限现在归属于你的 Google Cloud 项目:Test、Explorer、Basic 和 Standard 级别及其获取方式。

HC作者:HelpCode 团队更新于 2 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

any ai client · Google Ads
How did our Google Ads account do in the last 30 days? Spend, conversions, cost per conversion and the main campaigns. Read only.
AI
正在调用gads_list_accessible_customersgads_campaign_performancegads_account_daily_metricsgads_conversion_actions
One Performance Max campaign carried all spend and conversions; the Search campaign is paused. The cost per conversion looks too good for B2B: two short bursts of clicks at about one cent produced most of the month's conversions, and almost all of them are one sign-up action tracked as a page visit. Compare those days with real sign-ups before trusting the campaign's optimization.
gads_playbookgads_campaign_performancegads_search_termsgads_keyword_performancegads_budget_pacinggads_run_gaql+ 更多
  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

4 分钟配置后即可使用的真实提示词。

安装连接器后,把这些提示词粘贴到你的 AI 客户端。每条提示词下方列出的工具会由智能体自动调用。

“List the search terms from the last 30 days that cost money and never converted, grouped into negative keyword ideas.”
gads_search_termsgads_run_gaql
“Which keywords have a Quality Score of 5 or lower, and which component is below average?”
gads_keyword_performance
“Are my Search campaigns losing impression share to budget or to rank?”
gads_budget_pacing
“Who changed bids or budgets in the account last week?”
gads_change_history

跳过安装。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 中,在该连接器上运行。

Google Ads · 通过 MCP 实时
分享
Opus 4.7

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 回答一个问题通常需要两到八次。

现在如何获取访问权限

  1. 打开 console.cloud.google.com,选择或创建一个项目,然后进入 APIs & Services → Library,启用 Google Ads API。
  2. 打开项目的 Google Ads API 页面。页面上会显示当前的访问级别;展开 Upgrade access level,申请 Explorer(或在品牌验证后申请 Basic)。
  3. 在 APIs & Services → Credentials 下创建一个 OAuth client ID,并将 OAuth consent screen 设为 In production(在 Testing 模式下,refresh token 会在 7 天后过期)。
  4. 用一个有权访问广告账号的 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 的 开发者令牌 和 访问级别 页面。

相关指南

这份指南对你有帮助吗?

你的 Google Ads 智能体只差一次点击。

安装连接器,粘贴密钥,向你的 AI 客户端提问。免费试用 7 天,无需信用卡。

相关指南

连接器

如何将 Google Ads 连接到 ChatGPT:通过 MCP 读取广告系列数据

把 Google Ads 作为开发者模式应用添加到 ChatGPT:ChatGPT 从你的账号读取广告系列、搜索字词、质量得分和预算。只读,无需开发者令牌。

连接器

如何将 Google Ads 连接到 Claude:15 分钟配置自定义连接器

把 Google Ads 作为自定义连接器添加到 claude.ai 和 Claude 桌面端:Claude 读取广告系列、搜索字词、质量得分和预算。只读,无需开发者令牌。

连接器

如何将 Google Ads 连接到 Cursor — 通过 MCP

面向 AI agent 的 Google Ads:广告系列、广告组、广告和关键字效果,搜索字词,质量得分,预算消耗进度和展示次数份额,转化操作,更改历史记录,建议,经理(MCC)账号,以及任意 GAQL 查询。17 个只读工具,OAuth2。

连接器

如何将 Google Ads 连接到 Gemini — 通过 MCP

面向 AI agent 的 Google Ads:广告系列、广告组、广告和关键字效果,搜索字词,质量得分,预算消耗进度和展示次数份额,转化操作,更改历史记录,建议,经理(MCC)账号,以及任意 GAQL 查询。17 个只读工具,OAuth2。

连接器

用 Claude 审核 Google Ads:在你自己的账号上经过测试的方法

几分钟内用 Claude 审核 Google Ads 账号:支出、转化质量、浪费的搜索字词、质量得分、预算和跟踪,数据直接来自 API。

连接器

Google Ads MCP 服务器:将 Google Ads 连接到 Claude、ChatGPT 和任意 agent

向 Claude 或 ChatGPT 询问你的 Google Ads:广告系列、搜索字词、质量得分、预算、转化。只读,无需开发者令牌,15 分钟完成设置。