最後更新:2026-11-16(Google Ads API、Anthropic、OpenAI 官方文件皆於當天查閱;目前 API 版本 v26.2)
Google Ads API 在 2026 年改了遊戲規則:開發人員權杖於 2026-09-09 停用,存取等級改綁 Google Cloud 專案(官方說明)。很多「照舊教學做卻連不上」的問題都出在這裡。本文從驗證、專案、管理員帳戶三個層次幫你排查 Claude 與 Google Ads MCP 伺服器的連線。
先搞清楚:你用的是哪種驗證
| 驗證方式 | 適用 | 常見問題 |
|---|---|---|
| 使用者 OAuth(ADC) | 本機 stdio,個人使用 | 範圍少了 adwords;用錯專案的用戶端 |
| 服務帳戶 | 伺服器、排程 | 服務帳戶需被加入 Google Ads 帳戶的使用者 |
| OAuth Web 用戶端 | Cloud Run 遠端 | 回呼網址、同意畫面範圍、測試使用者 |
| (已停用)開發人員權杖 | — | 送了也會被忽略 |

本機模式用應用程式預設憑證(ADC),可來自 OAuth 用戶端密鑰 JSON 或服務帳戶;遠端模式需要 OAuth Web 應用程式用戶端(官方指南)。決定存取等級的是擁有 OAuth 用戶端或服務帳戶的那個 Google Cloud 專案,不是你在 Console 目前選的專案。
存取等級對照
- Test:只能存取測試帳戶,每天 15,000 次操作。
- Explorer:可存取正式帳戶,每天最多 2,880 次操作;限制帳戶建立、使用者管理、關鍵字規劃等規劃服務、帳單相關服務。
- Basic:每天 15,000 次;Standard:不限(
- 存取等級
- )。新申請 Basic、Standard 需完成品牌驗證。
用 Test 專案呼叫正式帳戶,v25 起會回傳 CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION,v24 以前是 ACTION_NOT_PERMITTED。
5 種症狀的排查順序
| 症狀 | 先查 | 再查 |
|---|---|---|
| 列不出任何帳戶 | ADC 是否用對帳號登入 | 該 Google 帳號是否有 Google Ads 存取權 |
| 能列帳戶但查不到資料 | 是否需要 login_customer_id | 專案是否已是 Explorer 以上 |
| 某些服務呼叫失敗 | 是否為 Explorer 受限服務 | 是否需要 Basic/Standard |
| 只有某個客戶帳戶失敗 | 管理員帳戶連結是否有效 | 該帳戶是否已取消或受停權影響 |
| 寫入被拒 | tools_config 是否關閉寫入 | Claude Code 權限規則 |

服務帳戶的眉角
用服務帳戶時,把 GOOGLE_APPLICATION_CREDENTIALS 指向金鑰檔,或用 gcloud 的 --impersonate-service-account 產生 ADC。服務帳戶本身也需要在 Google Ads 帳戶中具備存取權。金鑰檔請放在密鑰管理服務或受控主機,不要提交到 Git、不要貼進對話。
管理員帳戶(MCC)
透過管理員帳戶操作客戶帳戶時,需要告訴 API 登入的管理員帳戶:在 MCP 設定 GOOGLE_ADS_LOGIN_CUSTOMER_ID,或每次呼叫傳 login_customer_id(後者優先)。此外,每個寫入請求只能針對一個 customer_id,帳戶無法修改由其他帳戶建立的物件,除非以已授權的管理員帳戶身分登入(Mutate resources)。
一份可以照抄的設定
# google-ads.yaml - no developer_token needed after the 2026-09-09 sunset
# Option A: application default credentials (google-ads >= 28.3.0)
use_application_default_credentials: True
# Option B: OAuth user refresh token (use ONE auth group only)
# client_id: ${from secret manager}
# client_secret: ${from secret manager}
# refresh_token: ${from secret manager}
login_customer_id: 1234567890 # manager account, 10 digits, no hyphens
use_proto_plus: True上面是 google-ads Python 用戶端的設定檔(給 Codex/Claude 寫的腳本用),驗證欄位只能選一組(設定說明)。MCP 伺服器本身則讀環境變數:
{
"mcpServers": {
"google-ads-mcp": {
"command": "pipx",
"args": ["run", "--spec", "google-ads-mcp==0.0.6", "google-ads-mcp"],
"env": {
"GOOGLE_CLOUD_PROJECT": "PROJECT_ID",
"GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON"
}
}
}
}還是不行?
- 執行
claude mcp list確認伺服器狀態。 - 請 Claude 呼叫 customers_list_accessible_customers,確認驗證成功。
- 換一個確定有權限的客戶 ID 測試 search_search。
- 檢查是否誤把寫入工具關閉(這通常是你刻意設定的保護)。
- 仍無法解決,到 GitHub issues 或 Discord 的 #ads-api-ai-tools 提問(不要貼出任何憑證)。
熊貓出海如何用 Claude、Codex 與 Google 廣告帳戶幫客戶提升投放效率
本文主角是 Claude,但在實際服務中,熊貓出海會把 Claude、Codex 與 Google Ads 帳戶組合使用,協助出海企業更快跑完「開戶與轉換追蹤 → 建立廣告活動 → 撰寫素材 → 看報表與搜尋字詞 → 調整預算與排除關鍵字」這套重複工作,讓投手把時間留給策略、出價判斷與素材。
- 廣告帳戶:使用企業自己的 Google Ads 帳戶,或透過熊貓出海開戶服務合規開通的帳戶;帳戶歸企業所有,不出租、不共享。多帳戶時以企業自己的管理員帳戶(MCC)授權。
- Claude:透過 Google 開源的 Google Ads MCP 伺服器以自然語言查數(GAQL)、診斷曝光比重與搜尋字詞、撰寫 RSA 標題說明與額外資訊初稿,並在「先提議、後確認」模式下建立素材與標籤。
- Codex:撰寫與維護 google-ads Python 腳本(日報、搜尋字詞清理、批次建立暫停的廣告活動、validate_only 預檢),在沙盒中執行並接入排程或 CI。
- 人工把關:啟用廣告活動、提高預算、變更出價目標皆由投手審核後執行;Google Ads 政策與到達網頁合規由人工最終確認。
這是服務能力說明,不涉及任何價格或回饋承諾;我們也不是 Google、Anthropic 或 OpenAI 的官方合作夥伴。開戶與代操流程請見 Google 廣告開戶與代操(熊貓出海服務頁)。
常見問題
舊專案的存取等級會不見嗎?
不會。停用前 90 天有 API 活動的權杖等級,已自動轉移到相應的 Google Cloud 專案。
API Center 還能用嗎?
可查看歷史資料,但申請與管理已移到 Cloud Console;只有 App Conversion Tracking API 仍需從 API Center 申請權杖。
Explorer 能用關鍵字規劃嗎?
不行,KeywordPlanIdeaService 等規劃服務需要 Basic 或 Standard。
連線排查要給熊貓出海帳密嗎?
不需要也不應該。我們只需要錯誤訊息(去除憑證)與設定結構,憑證永遠由企業自己保管。
合規說明:本文所有自動化都應只用於企業自有或已獲正式授權的 Google Ads 帳戶(含管理員帳戶 MCC 底下的客戶帳戶),透過 Google 官方 Google Ads API、Google 開源的 Google Ads MCP 伺服器或 Google Ads 編輯器等官方工具接入,遵守《Google Ads API 條款》、API 配額與《Google Ads 政策》,並在任何會產生花費的動作前保留人工審核。熊貓出海不販售、出租、共享或轉讓廣告帳戶、MCC 或 API 憑證,不協助規避廣告審查、地區限制、身分驗證或付款管控,也不是 Google、Anthropic 或 OpenAI 的官方合作夥伴。Claude 與 OpenAI 服務僅提供給支援國家/地區的客戶,請由在支援地區合法設立並實際營運的主體開通並負責。
延伸閱讀
- Google 廣告開戶與代操(熊貓出海服務頁)
- 海外 AI Token 服務:帳號開通 + API 接入(熊貓出海)
- 如何將 Claude 連結到 Google 廣告
- Claude 自動化 Google Ads 的政策合規與帳戶安全
- Codex 自動化 Google Ads 的存取等級、測試帳戶與合規
- Google 開發了 MCP,讓 AI 直接操作你的廣告投放
- Claude 連結 Facebook 廣告:權杖與權限疑難排解(Facebook 篇)
- AI Token 是什麼?
聯絡熊貓出海:Google 廣告開戶 + AI 自動化投放
請告訴我們公司登記地、產業、目標國家、到達網頁連結與預估月預算,以及想先自動化哪一段(報表、搜尋字詞、素材或建立廣告活動)。我們先做資格與到達網頁預審,再協助企業合規開通自有 Google Ads 帳戶,並把 Claude / Codex 接入你的投放流程。
WhatsApp:+852 5904 8602Telegram:@PANDA0134WeChat/微信:szcwh99

官方來源
- Google: Developer token sunset (2026-09-09) and FAQ
- Google: Google Ads API access levels
- Google: Google Ads MCP server – developer integration guide
- GitHub: googleads/google-ads-mcp
- Google: Mutate resources
- Google: Python client library configuration
- Anthropic: Connect Claude Code to tools via MCP
以上官方頁面皆於 2026-11-16 查閱。API 版本、工具名稱與權限要求會變動,請以官方頁面為準。

微信扫一扫打赏
支付宝扫一扫打赏
