首页 AI Claude × Google Ads API 自動建立廣告活動(2026):google-ads Python、臨時資源名稱、validate_only 預檢與暫停建立

Claude × Google Ads API 自動建立廣告活動(2026):google-ads Python、臨時資源名稱、validate_only 預檢與暫停建立

用 Claude 依 Brief 產生 Google Ads 廣告活動腳本:google-ads Python 用戶端、google-ads.yaml(免開發人員權杖)、臨時資源名稱一次建立預算與廣告活動、validate_only 預檢、PAUSED 狀態與人工啟用。

最後更新: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 上限
Google Ads API 建立廣告活動的關鍵欄位對照表

兩個最容易被 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 狀態。

流程

Claude 產生 Google Ads 廣告活動腳本的 5 個步驟

4 種寫入方式怎麼選

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

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 自動化投放

請告訴我們公司登記地、產業、目標國家、到達網頁連結與預估月預算,以及想先自動化哪一段(報表、搜尋字詞、素材或建立廣告活動)。我們先做資格與到達網頁預審,再協助企業合規開通自有 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-api-campaign-creation-python-zh-tw.html
上一篇
下一篇

作者: 熊猫出海编辑团队

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

为您推荐

发表回复

联系我们

联系我们

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

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

微信扫一扫关注我们

关注微博
返回顶部