首页 AI Claude 連結 Google Ads 疑難排解(2026):開發人員權杖停用後的 OAuth、存取等級、服務帳戶與管理員帳戶權限

Claude 連結 Google Ads 疑難排解(2026):開發人員權杖停用後的 OAuth、存取等級、服務帳戶與管理員帳戶權限

Claude 連結 Google Ads 失敗?從開發人員權杖停用後的新規則逐項排查:OAuth 用戶端所屬專案、Test 與 Explorer 等級、服務帳戶、管理員帳戶 login_customer_id、使用者角色與 Explorer 受限服務。

最後更新: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 遠端回呼網址、同意畫面範圍、測試使用者
(已停用)開發人員權杖—送了也會被忽略
Google Ads API 三種驗證方式與常見問題對照表

本機模式用應用程式預設憑證(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 權限規則
Claude 連結 Google Ads 的 5 種症狀與排查順序

服務帳戶的眉角

用服務帳戶時,把 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"
      }
    }
  }
}

還是不行?

  1. 執行 claude mcp list 確認伺服器狀態。
  2. 請 Claude 呼叫 customers_list_accessible_customers,確認驗證成功。
  3. 換一個確定有權限的客戶 ID 測試 search_search。
  4. 檢查是否誤把寫入工具關閉(這通常是你刻意設定的保護)。
  5. 仍無法解決,到 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 自動化投放

請告訴我們公司登記地、產業、目標國家、到達網頁連結與預估月預算,以及想先自動化哪一段(報表、搜尋字詞、素材或建立廣告活動)。我們先做資格與到達網頁預審,再協助企業合規開通自有 Google Ads 帳戶,並把 Claude / Codex 接入你的投放流程。

WhatsApp:+852 5904 8602Telegram:@PANDA0134WeChat/微信:szcwh99

熊貓出海 WeChat QR 微信:szcwh99

官方來源

以上官方頁面皆於 2026-11-16 查閱。API 版本、工具名稱與權限要求會變動,請以官方頁面為準。

本文来自网络,不代表熊猫出海立场。转载请注明出处: https://www.pandawm.com/blog/claude-google-ads-oauth-access-level-troubleshooting-zh-tw.html
上一篇
下一篇

作者: 熊猫出海编辑团队

熊猫出海(PandaWM)编辑团队,来自香港出海服务商熊猫出海,专注 Facebook、TikTok、Google 等海外广告开户与代投,以及 GEO/AI 搜索优化、多语言独立站建设。有Facebook白名单牌照户、TikTok加白户、Google G2认证户等核心资源 。

为您推荐

发表回复

联系我们

联系我们

工作时间:周一至周五,9:00-17:30,节假日休息

关注微信
微信扫一扫关注我们

微信扫一扫关注我们

关注微博
返回顶部