最後更新:2026-11-16(Google Ads API、Anthropic、OpenAI 官方文件皆於當天查閱;目前 API 版本 v26.2)
Google 開源的 Google Ads MCP 伺服器不能建立或修改廣告活動、廣告群組、廣告、預算與出價(官方指南)。所以要讓 Claude 參與「建活動」,正確做法是:Claude 寫 Google Ads API 腳本,人審核後執行。本文示範一支可直接改用的 Python 腳本,從 Brief 到一個暫停狀態的搜尋廣告活動。
先準備:用戶端與設定檔
安裝官方 Python 用戶端 pip install google-ads(支援 Python 3.9–3.14,建議 3.11 以上,官方說明)。開發人員權杖已於 2026-09-09 停用,設定檔不再需要它;存取等級改看 Google Cloud 專案(停用說明)。設定檔只能選一組驗證方式:
# 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設定欄位與環境變數清單見 Configuration。用戶端密鑰、更新權杖都放在密鑰管理服務,不要貼進對話或程式庫。
建立廣告活動的 6 個關鍵欄位
| 欄位 | 必填? | 要注意的地方 |
|---|---|---|
| campaign_budget.amount_micros | 是 | 金額以 micros 計,1 單位 = 1,000,000 |
| campaign.advertising_channel_type | 是 | 建立後不能更改(SEARCH、PERFORMANCE_MAX 等) |
| campaign.status | 否 | 不填預設為 ENABLED,務必設為 PAUSED |
| campaign.campaign_budget | 是 | 可引用同一請求中的臨時資源名稱(-1) |
| campaign.contains_eu_political_advertising | 是 | 自我聲明是否含歐盟政治廣告 |
| 出價策略 | 是 | 例如 target_spend(盡量爭取點擊)加 CPC 上限 |

兩個最容易被 AI 漏掉的細節:status 不填就是 ENABLED,以及contains_eu_political_advertising 是必填。把這兩點寫進 CLAUDE.md,讓 Claude 每次產生腳本都檢查(Create campaigns)。
完整腳本:一次原子請求建立預算 + 廣告活動
利用臨時資源名稱(負數 ID,例如 -1),可以在同一個 Mutate 請求中先建立預算、再讓廣告活動引用它;引用必須出現在定義之後,且只在同一請求內有效(Mutate best practices)。
# create_paused.py - budget + Search campaign in ONE atomic mutate, validate first
import sys
from google.ads.googleads.client import GoogleAdsClient
def build(client, cid, name, daily_budget):
ga = client.get_service("GoogleAdsService")
budget_rn = ga.campaign_budget_path(cid, "-1") # temporary resource name
op_b = client.get_type("MutateOperation")
b = op_b.campaign_budget_operation.create
b.resource_name = budget_rn
b.name = f"{name} budget"
b.amount_micros = int(daily_budget * 1_000_000) # account currency x 1e6
b.delivery_method = client.enums.BudgetDeliveryMethodEnum.STANDARD
b.explicitly_shared = False
op_c = client.get_type("MutateOperation")
c = op_c.campaign_operation.create
c.name = name
c.campaign_budget = budget_rn # refers to -1 above
c.advertising_channel_type = client.enums.AdvertisingChannelTypeEnum.SEARCH
c.status = client.enums.CampaignStatusEnum.PAUSED # default would be ENABLED
c.target_spend.cpc_bid_ceiling_micros = 2_000_000 # Maximize clicks + CPC cap
c.network_settings.target_google_search = True
c.network_settings.target_search_network = True
c.contains_eu_political_advertising = (
client.enums.EuPoliticalAdvertisingStatusEnum.DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING)
return ga, [op_b, op_c]
def run(cid, name, daily_budget, commit=False):
client = GoogleAdsClient.load_from_storage("google-ads.yaml")
ga, ops = build(client, cid, name, daily_budget)
req = client.get_type("MutateGoogleAdsRequest")
req.customer_id = cid
req.mutate_operations.extend(ops)
req.validate_only = not commit # dry run unless --commit
resp = ga.mutate(request=req)
print("validated only" if not commit else resp.mutate_operation_responses)
if __name__ == "__main__":
run(sys.argv[1], sys.argv[2], float(sys.argv[3]), commit="--commit" in sys.argv)預設執行 validate_only=True,只驗證不寫入;確認無誤後加 --commit 才真正建立,而且建立出來的是 PAUSED 狀態。
流程

4 種寫入方式怎麼選
| 做法 | 優點 | 缺點 | 建議用在 |
|---|---|---|---|
| GoogleAdsService.Mutate(原子) | 整組成功或整組失敗,可用臨時資源名稱 | 單次最多 10,000 個操作 | 新建一組完整結構 |
| partial_failure=true | 有效操作照常送出 | 要自己處理部分失敗 | 大量更新 |
| BatchJobService | 非同步、適合超大量 | 一律部分失敗、不支援 validate_only | 上萬筆操作 |
| validate_only=true | 只驗證不寫入 | 仍消耗配額 | 每次送出前預檢 |

Google 文件指出:GoogleAdsService.Mutate 可讓整組操作原子成功或失敗,也可設定 partial_failure;BatchJobService 一律以部分失敗執行,且不支援 validate_only(Mutate resources)。每個請求只能針對一個 customer_id;透過管理員帳戶操作客戶帳戶時要設定 login-customer-id。
配額提醒
- Explorer 等級對正式帳戶每天最多 2,880 次操作;單一請求最多 10,000 個 mutate 操作(
- 配額
- )。
- Explorer 等級無法使用帳戶建立、使用者管理、關鍵字規劃等服務,需要時申請 Basic 或 Standard(
- 存取等級
- )。
- 被拒絕的請求一樣計入配額,所以 validate_only 預檢與重試上限都很重要。
熊貓出海如何用 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 廣告開戶與代操(熊貓出海服務頁)。
常見問題
可以讓 Claude 直接執行 –commit 嗎?
技術上可以,但不建議。讓 Claude 產生腳本與預檢結果,由人執行 –commit;啟用廣告活動則在 Google Ads 後台由投手完成。
還要申請開發人員權杖嗎?
不用,2026-09-09 已停用,送了也會被忽略。只有 App Conversion Tracking API 仍需從 API Center 申請。
Performance Max 也能這樣建嗎?
可以用 API 建立,但需要素材群組等更多資源;建議先從搜尋廣告活動開始,熟悉後再擴展。PMax 概念見 PMax 广告是什么?Performance Max 入门。
我沒有正式帳戶能測嗎?
可以建立測試管理員帳戶與測試帳戶;測試帳戶不會投放、沒有帳單,Test 等級專案即可呼叫。
合規說明:本文所有自動化都應只用於企業自有或已獲正式授權的 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 Ads 的政策合規與帳戶安全
- 如何將 Claude 連結到 Google 廣告
- Codex 批次建立 Google Ads 素材與標籤
- Google 開發了 MCP,讓 AI 直接操作你的廣告投放
- Claude × Facebook Marketing API 建立行銷活動(Facebook 篇)
- Gemini API Key 申請教學(2026)
- AI Token 是什麼?
聯絡熊貓出海:Google 廣告開戶 + AI 自動化投放
請告訴我們公司登記地、產業、目標國家、到達網頁連結與預估月預算,以及想先自動化哪一段(報表、搜尋字詞、素材或建立廣告活動)。我們先做資格與到達網頁預審,再協助企業合規開通自有 Google Ads 帳戶,並把 Claude / Codex 接入你的投放流程。
WhatsApp:+852 5904 8602Telegram:@PANDA0134WeChat/微信:szcwh99

官方來源
- Google: Create campaigns
- Google: Mutate best practices
- Google: Mutate resources
- Google: Python client library (google-ads)
- Google: Python client library configuration
- Google: Developer token sunset (2026-09-09) and FAQ
- Google: Google Ads API access levels
- Google: API limits and quotas
- Google: Google Ads MCP server – developer integration guide
- Google: Test accounts
以上官方頁面皆於 2026-11-16 查閱。API 版本、工具名稱與權限要求會變動,請以官方頁面為準。

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