最后更新: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 | 看异常、做决策 |

第 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(交互) | 开发脚本、调试 GAQL | codex mcp add 接入 Google Ads MCP |
| codex exec(非交互) | 定时日报、CI | 默认只读沙盒;–output-schema 结构化输出 |
| Codex SDK | 嵌入内部工具 | 以代码驱动线程与沙盒 |
| Google agent skills | 让 Codex 少走弯路 | google-ads-api-mcp-setup、account-diagnostics 等 |

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 Token 服务:帐号开通 + API 接入(熊猫出海)
- 用 Codex 写 Google Ads 日报与搜索词脚本
- Claude 操作 Google 广告投放全流程自动化
- 如何将 Claude 链接到 Google 广告(Google Ads MCP 教程)
- Google 开发了 MCP:让 AI 直接操作你的广告投放
- Codex 操作 Facebook 广告全流程自动化(Facebook 篇)
- 出海营销用哪个 AI 智能体?
- 大模型 API Key 申请与安全管理
- 谷歌广告投放入门教程(AI 出海公司版)
联系熊猫出海:Google 广告开户 + AI 自动化投放
告诉我们公司主体所在地、行业、目标国家、落地页链接和预计月预算,以及你想先自动化哪一段(报表、搜索词、素材还是建系列)。我们先做资质与落地页预审,再协助企业合规开通自有 Google Ads 帐户,并把 Claude / Codex 接入到你的投放流程。
WhatsApp:+852 5904 8602Telegram:@PANDA0134微信:szcwh99

官方来源
- Google: Google Ads MCP server – developer integration guide
- GitHub: googleads/google-ads-mcp
- Google: Developer token sunset (2026-09-09) and FAQ
- Google: Google Ads API access levels
- Google: Create campaigns
- Google: Google Ads API AI agent skills
- OpenAI: Codex and MCP
- OpenAI: Codex non-interactive mode (codex exec)
- OpenAI: Custom instructions with AGENTS.md
- OpenAI: Codex agent approvals & security
- OpenAI: Supported countries and territories
以上官方页面均于 2026-11-16 查阅。API 版本、工具名称与权限要求会变化,请以官方页面为准。

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