首页 AI Codex 操作 Google 广告投放全流程自动化(2026 实战):Codex CLI + Google Ads MCP + google-ads Python 脚本

Codex 操作 Google 广告投放全流程自动化(2026 实战):Codex CLI + Google Ads MCP + google-ads Python 脚本

用 OpenAI Codex 自动化 Google Ads 投放全流程:Codex CLI 接入 Google 开源 Google Ads MCP 服务器、AGENTS.md 规则、google-ads Python 脚本、validate_only 预检、codex exec 定时任务与人工审核节点。

最后更新:2026-11-16(Google Ads API、Anthropic、OpenAI 官方文档均于当天查阅;当前 API 版本 v26.2)

如果说 Claude 更像「会写代码的投放分析师」,OpenAI Codex 更像「会懂投放的工程师」:它擅长在仓库里写、改、测脚本,并在沙盒中运行。Google Ads 自动化恰好需要大量脚本,因为 Google 开源的 Google Ads MCP 服务器只覆盖查询、素材和标签,不能创建或修改系列、广告组、广告、预算与出价(官方指南)。这些都要靠 Google Ads API 脚本完成。

Google Ads API 当前版本为 v26.2(2026-11-11 发布);开发者令牌已于 2026-09-09 停用,API 访问级别改为按 Google Cloud 项目授予:启用 API 即获 Test 级别(仅测试帐户,每天 15,000 次操作),可在 Cloud Console 的 Google Ads API 概览页申请 Explorer 级别(生产帐户每天最多 2,880 次操作,多数情况自动审核通过)。

一张表看懂 Codex 在流程里的位置

环节Codex 做什么产出人工节点
1 规则读 AGENTS.md:帐户白名单、PAUSED、micros—维护规则文件
2 查数经 MCP 调 search_search 或写 GAQL 脚本CSV/JSON 报表阅读结论
3 建系列写 google-ads mutate 脚本 + 测试create_paused.py代码审查
4 预检运行 validate_only校验结果确认变更
5 提交–commit 建 PAUSED 系列新系列 ID投手在后台启用
6 定时codex exec 只读分析日报report.json看异常、做决策
Codex 自动化 Google Ads 全流程 6 个环节分工表

第 1 步:把规则写进 AGENTS.md

Codex 在每次任务前读取仓库根目录的 AGENTS.md(AGENTS.md 说明)。把帐户白名单、PAUSED、micros 单位、validate_only 等规则写进去:

# AGENTS.md (repo root) - rules Codex reads before every task
## Google Ads automation rules
- Only touch customer IDs listed in accounts.allowlist (our own / client-authorised).
- Credentials come from ADC or a secret manager. Never print, log, commit or paste
  client secrets or refresh tokens. No developer token is needed (sunset 2026-09-09).
- Every new campaign is created with status=PAUSED. Never enable campaigns or raise
  budgets; output a change list for a human instead.
- Money fields are micros (1 unit = 1,000,000). Budget change > 20% needs a human.
- Run every mutate with validate_only=True first; commit only with --commit.
- Stay within our access level quota (Explorer: 2,880 ops/day on production).
- Ad text must follow Google Ads policies; flag health, finance, gambling,
  employment, housing and political content for human review.
- Run `pytest -q` before proposing changes.

第 2 步:接入 Google Ads MCP

Google 的 README 给出了 Codex 接入远程实例的方式;本地 stdio 则用 codex mcp add … -- 命令(Codex MCP 文档):

# 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

本地运行前需要用 gcloud 生成带 adwords 作用域的 ADC:

# 1) Google Cloud project: enable the Google Ads API (grants Test access),
#    then apply for Explorer access on the "Google Ads API Overview" page.
# 2) Local ADC with the adwords scope (OAuth client JSON from the same project)
gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=client_secret.json

第 3 步:让 Codex 写建系列脚本

给 Codex 的任务描述可以这样写:「按 brief.md 用 google-ads Python 写 create_paused.py:一个 mutate 请求里用临时资源名称同时建预算和搜索系列,status 必须 PAUSED,默认 validate_only,加 –commit 才提交,并写 pytest」。Codex 产出的核心逻辑类似:

# 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)

脚本细节(临时资源名称、原子提交、partial_failure)在英文篇 Codex + Google Ads API Python campaign pipeline 里有逐段解释。

第 4 步:定时日报交给 codex exec

codex exec 默认在只读沙盒中运行,适合定时任务(非交互模式)。推荐「脚本取数 + Codex 只读分析」:

# nightly: pull data with a plain script, let Codex analyse it read-only
python report.py 1234567890
codex exec --ephemeral --output-schema report_schema.json -o report.json \
  "Read report_yesterday.csv. Summarise cost, clicks, conversions and search \
impression share per campaign, list anomalies vs the 7-day average and propose \
(do not apply) budget or negative-keyword changes."

日报脚本与搜索词清洗的完整做法见 用 Codex 写 Google Ads 日报与搜索词脚本。

Codex 的 4 种用法

工具适合场景Google 相关能力
Codex CLI(交互)开发脚本、调试 GAQLcodex mcp add 接入 Google Ads MCP
codex exec(非交互)定时日报、CI默认只读沙盒;–output-schema 结构化输出
Codex SDK嵌入内部工具以代码驱动线程与沙盒
Google agent skills让 Codex 少走弯路google-ads-api-mcp-setup、account-diagnostics 等
Codex 各形态与 Google Ads 自动化的适配对比表

Google 还发布了面向 AI 代理的 agent skills,可装进 Claude Code、Codex、Cursor 与 Antigravity,帮助代理完成 MCP 设置、帐户诊断和 API 入门(agent skills):

# Google's agent skills for Google Ads (works with Claude Code, Codex, Cursor, Antigravity)
npx skills add google/skills/skills/ads
# includes e.g. google-ads-api-mcp-setup, google-ads-api-account-diagnostics,
# google-ads-api-quickstart

常见坑

  • 金额单位:Google Ads API 用 micros,Facebook 用「分」,两套脚本不要混用。
  • 访问级别:用 Test 级别项目调用生产帐户,v25 及以后会报 CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION,需要申请 Explorer(
  • 官方说明
  • )。
  • 沙盒网络:workspace-write 沙盒默认关闭网络,调用 API 的步骤要么在沙盒外由人执行,要么显式授权(
  • Codex 安全
  • )。

熊猫出海如何用 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 广告开户与投放(熊猫出海服务页)。

常见问题

Codex 和 Claude 选哪个?

不必二选一。我们的做法是 Claude 负责查数、解读和文案,Codex 负责脚本和定时任务;两者共用同一套规则文件。对比可看 Claude 操作 Google 广告投放全流程自动化。

Codex 能直接启用系列吗?

脚本技术上可以,但我们在 AGENTS.md 中禁止:系列一律 PAUSED 创建,启用由投手完成。

需要开发者令牌吗?

不需要,2026-09-09 已停用;访问级别看 Google Cloud 项目。

中国大陆团队能用 Codex 吗?

OpenAI 只向支持国家/地区提供服务,中国大陆和香港不在列表中,请由支持地区的合法主体开通,参考 ChatGPT API 怎么购买?企业开通 OpenAI API。

合规说明:本文所有自动化都应只用于企业自有或已获正式授权的 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:@PANDA0134微信:szcwh99

熊猫出海微信二维码 szcwh99

官方来源

以上官方页面均于 2026-11-16 查阅。API 版本、工具名称与权限要求会变化,请以官方页面为准。

本文来自网络,不代表熊猫出海立场。转载请注明出处: https://www.pandawm.com/blog/codex-google-ads-automation-end-to-end-workflow-2026.html
上一篇
下一篇

作者: 熊猫出海编辑团队

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

为您推荐

发表回复

联系我们

联系我们

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

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

微信扫一扫关注我们

关注微博
返回顶部