最後更新:2026-11-16(Google Ads API、Anthropic、OpenAI 官方文件皆於當天查閱;目前 API 版本 v26.2)
一個多市場的 Google Ads 帳戶,常常需要上百條宣傳文字、網站連結和結構化摘要。這類「量大、規則明確」的工作很適合交給 Codex:它產生草稿、透過 Google 開源的 Google Ads MCP 伺服器建立素材,再寫一支 API 腳本把素材連結到廣告活動。
6 項工作怎麼分
| 工作 | 用什麼 | 誰執行 | 備註 |
|---|---|---|---|
| 產生宣傳文字/網站連結草稿 | Codex 讀 Brief 產 CSV | Codex | 附字數檢查 |
| 建立素材 | MCP assets_create_asset | Codex 提議、人確認 | validate_only + 校驗和 |
| 上傳影片 | MCP assets_upload_video_asset | 僅本機 stdio | 上傳到 YouTube |
| 連結到廣告活動 | API:CampaignAssetService | 人執行 –commit | MCP 不支援連結 |
| 加標籤 | MCP labels 工具 | Codex 提議、人確認 | 可貼在活動/群組/關鍵字 |
| 追蹤成效 | GAQL:campaign_asset | Codex 只讀 | 比較 AI 與人工素材 |

MCP 能建立哪些素材
| 素材類型 | MCP 參數 | 常見檢查 |
|---|---|---|
| TEXT | asset_type=TEXT | 字數、重複、禁用詞 |
| CALLOUT(宣傳文字) | asset_type=CALLOUT | 25 字元、不得誇大 |
| SITELINK(網站連結) | asset_type=SITELINK | 網址在白名單內 |
| STRUCTURED_SNIPPET(結構化摘要) | asset_type=STRUCTURED_SNIPPET | 標題須用 Google 提供的清單 |
| IMAGE | 本機路徑或 base64 | 遠端部署只能用 base64 |
| YOUTUBE_VIDEO | 影片 ID | 上傳僅 stdio |

依 Google 文件,assets_create_asset 支援 TEXT、IMAGE、YOUTUBE_VIDEO、SITELINK、CALLOUT、STRUCTURED_SNIPPET,其他類型可用 extra_params;image_asset_path 與 assets_upload_video_asset 僅限本機 stdio 模式(官方指南)。所有寫入工具都採「先提議、後確認」:先以 validate_only=True 回傳變更清單與 SHA-256 校驗和,確認後再帶相同參數與校驗和送出。
步驟 1:設定 Codex
# Codex CLI: add the Google Ads MCP server as a local stdio server
codex mcp add google-ads \
--env GOOGLE_CLOUD_PROJECT=my-gcp-project \
--env GOOGLE_ADS_LOGIN_CUSTOMER_ID=1234567890 \
-- pipx run --spec google-ads-mcp==0.0.6 google-ads-mcp
# or, if your team runs it as a shared Streamable HTTP service:
codex mcp add google_ads --url http://localhost:8080/mcp
codex mcp login google_ads
codex mcp list在 config.toml 中把 assets_create_asset 設為每次詢問(prompt),影片上傳先停用(完整設定見 Codex config.toml for the Google Ads MCP server):
# ~/.codex/config.toml (or a trusted project's .codex/config.toml)
[mcp_servers.google-ads]
command = "pipx"
args = ["run", "--spec", "google-ads-mcp==0.0.6", "google-ads-mcp"]
startup_timeout_sec = 60
enabled_tools = [
"customers_list_accessible_customers",
"search_search",
"metadata_get_resource_metadata",
"assets_create_asset",
]
disabled_tools = ["assets_upload_video_asset", "labels_manage_labels",
"labels_manage_label_associations"]
default_tools_approval_mode = "prompt"
[mcp_servers.google-ads.env]
GOOGLE_CLOUD_PROJECT = "my-gcp-project"
GOOGLE_ADS_LOGIN_CUSTOMER_ID = "1234567890"
GOOGLE_ADS_MCP_TOOLS_CONFIG = "/etc/pandawm/tools_config.readonly.yaml"
[mcp_servers.google-ads.tools.search_search]
approval_mode = "approve" # read tool: no prompt步驟 2:產生草稿並提議
對 Codex 下指令:「讀 brief.md 與 brand-rules.md,為台灣市場產生 12 條宣傳文字(每條 ≤25 字元,附字數),輸出 callouts.csv;人工標記 approved 後,逐條用 assets_create_asset 提議(validate_only=True),列出 change_items 等我確認。」
# Ask Claude/Codex (MCP) - propose first, commit after approval
1. "For customer 1234567890 create 4 CALLOUT assets from brief.md (max 25 chars each).
Use validate_only=True and show me change_items + checksum."
2. Human reviews text against Google Ads policies.
3. "Approved. Commit the same parameters with validate_only=False and that checksum."
4. "Create label 'ai-draft-2026-11' and attach it to campaign 2233445566." # labels tool
-- linking the assets to campaigns / ad groups is NOT supported by the MCP server:
-- do it in Google Ads UI, Editor, or with an API script you review.步驟 3:用 API 腳本連結到廣告活動
MCP 伺服器不能把素材連結到廣告活動、廣告群組或素材群組,這一步要用 Google Ads API。下面的腳本預設只驗證,--commit 才送出:
# link_callouts.py - attach reviewed callout assets to a campaign (MCP cannot link)
import sys
from google.ads.googleads.client import GoogleAdsClient
def run(cid, campaign_id, asset_ids, commit=False):
client = GoogleAdsClient.load_from_storage("google-ads.yaml")
ga = client.get_service("GoogleAdsService")
svc = client.get_service("CampaignAssetService")
ops = []
for aid in asset_ids:
op = client.get_type("CampaignAssetOperation")
ca = op.create
ca.campaign = ga.campaign_path(cid, campaign_id)
ca.asset = ga.asset_path(cid, aid)
ca.field_type = client.enums.AssetFieldTypeEnum.CALLOUT
ops.append(op)
req = client.get_type("MutateCampaignAssetsRequest")
req.customer_id = cid
req.operations.extend(ops)
req.validate_only = not commit
print(svc.mutate_campaign_assets(request=req))
if __name__ == "__main__":
run(sys.argv[1], sys.argv[2], sys.argv[3].split(","), commit="--commit" in sys.argv)google-ads Python 用戶端的安裝與設定見 官方說明;開發人員權杖已停用,不需再填(停用說明)。
步驟 4:標籤與成效追蹤
MCP 的標籤工具可建立、更新、移除帳戶標籤,並把標籤貼到 CAMPAIGN、CUSTOMER、AD_GROUP、AD_GROUP_CRITERION(廣告層級 AD_GROUP_AD 標籤不支援)。我們會把使用 AI 草稿的廣告活動貼上 ai-draft-2026-11,再用 GAQL 比較:
-- GAQL: callout assets linked to campaigns, and how they perform
SELECT asset.id, asset.type, asset.callout_asset.callout_text,
campaign.name, metrics.impressions, metrics.clicks
FROM campaign_asset
WHERE campaign_asset.field_type = 'CALLOUT'
AND segments.date DURING LAST_30_DAYS批次作業的配額與節奏
- Explorer 等級對正式帳戶每天最多 2,880 次操作(
- 存取等級
- );每條素材的提議與送出都會用到配額。
- 同類型操作分組送出效能較好(
- Mutate best practices
- )。
- 先在一個廣告活動試 2 週,比較 AI 與人工素材的點擊率,再擴大。
熊貓出海如何用 Claude、Codex 與 Google 廣告帳戶幫客戶提升投放效率
本文主角是 Codex,但在實際服務中,熊貓出海會把 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 廣告開戶與代操(熊貓出海服務頁)。
常見問題
為什麼建立用 MCP、連結用 API?
因為 MCP 伺服器刻意只開放獨立素材建立、影片上傳與標籤管理,連結與廣告活動層級變更都不支援。
遠端部署能上傳圖片嗎?
可以,但要用 base64 的 image_asset_data;本機檔案路徑只在 stdio 模式可用。
可以一次建立幾百條素材嗎?
技術上可以,但要考慮配額與人工審核量。建議分批,每批都先提議、再確認。
AI 寫的宣傳文字要注意什麼?
避免無法佐證的最高級用語與不實陳述,並遵守 Google Ads 編輯標準。合規邊界見 Claude 自動化 Google Ads 的政策合規與帳戶安全。
合規說明:本文所有自動化都應只用於企業自有或已獲正式授權的 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 接入(熊貓出海)
- Codex 自動化 Google Ads 的存取等級、測試帳戶與合規
- Claude × Google Ads API 自動建立廣告活動(Python)
- 如何將 Claude 連結到 Google 廣告
- Google 開發了 MCP,讓 AI 直接操作你的廣告投放
- Codex 批量上傳 Facebook 廣告素材(Facebook 篇)
- Gemini API Key 申請教學(2026)
聯絡熊貓出海:Google 廣告開戶 + AI 自動化投放
請告訴我們公司登記地、產業、目標國家、到達網頁連結與預估月預算,以及想先自動化哪一段(報表、搜尋字詞、素材或建立廣告活動)。我們先做資格與到達網頁預審,再協助企業合規開通自有 Google Ads 帳戶,並把 Claude / Codex 接入你的投放流程。
WhatsApp:+852 5904 8602Telegram:@PANDA0134WeChat/微信:szcwh99

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

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