最后更新:2026-11-16(Google Ads API、Anthropic、OpenAI 官方文档均于当天查阅;当前 API 版本 v26.2)
投放团队每天重复最多的两件事:看日报和清搜索词。这两件事非常适合让 Codex 写成脚本——逻辑清楚、可测试、可定时。本文给出三支可直接改用的 google-ads Python 脚本,以及一个用 codex exec 做只读分析的定时任务。
四个脚本各管什么
| 脚本 | 做什么 | 读/写 | 频率 |
|---|---|---|---|
| report.py | 导出昨日系列花费、点击、转化、搜索展示份额 | 只读 | 每天 |
| search_terms.py | 找出 30 天零转化但花费超阈值的搜索词 | 只读 | 每周 |
| add_negatives.py | 把人工标记 approved=yes 的词加为否定词 | 写(先预检) | 每周 |
| codex exec 分析 | 读 CSV,写摘要与调整建议 | 只读沙盒 | 每天 |

脚本 1:GAQL 日报导出
Google Ads 的报表通过 GAQL 查询,search_stream 适合一次拉完结果(GAQL 文档)。让 Codex 按下面的结构写:
# report.py - pip install google-ads ; GAQL via search_stream (read-only)
import csv, sys
from google.ads.googleads.client import GoogleAdsClient
QUERY = """
SELECT campaign.id, campaign.name, campaign.status,
metrics.cost_micros, metrics.clicks, metrics.conversions,
metrics.search_impression_share
FROM campaign
WHERE segments.date DURING YESTERDAY
AND campaign.status != 'REMOVED'
ORDER BY metrics.cost_micros DESC
"""
def main(customer_id: str):
client = GoogleAdsClient.load_from_storage("google-ads.yaml")
ga = client.get_service("GoogleAdsService")
with open("report_yesterday.csv", "w", newline="") as f:
w = csv.writer(f)
w.writerow(["campaign_id", "name", "status", "cost", "clicks", "conv", "search_is"])
for batch in ga.search_stream(customer_id=customer_id, query=QUERY):
for r in batch.results:
w.writerow([r.campaign.id, r.campaign.name, r.campaign.status.name,
r.metrics.cost_micros / 1e6, r.metrics.clicks,
r.metrics.conversions, r.metrics.search_impression_share])
if __name__ == "__main__":
main(sys.argv[1]) # customer ID, 10 digits, no hyphens配置文件 google-ads.yaml 不需要开发者令牌(已于 2026-09-09 停用,说明):
# 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脚本 2:零转化搜索词清单
-- GAQL: search terms with spend but no conversions in the last 30 days
SELECT search_term_view.search_term, campaign.name, ad_group.name,
metrics.cost_micros, metrics.clicks, metrics.conversions
FROM search_term_view
WHERE segments.date DURING LAST_30_DAYS
AND metrics.conversions = 0
AND metrics.cost_micros > 20000000
ORDER BY metrics.cost_micros DESC
LIMIT 200把结果导出成 CSV,加一列 approved 交给投手勾选。AI Max 与广泛匹配带来的新搜索词,可以结合 AI Max 流量怎么识别:{search_term_matchtype} 里的匹配类型参数一起判断。
脚本 3:人工批准后加否定词
只处理 approved=yes 的行;默认 validate_only 预检,开启 partial_failure 让单个错误不影响整批(Mutate resources):
# add_negatives.py - campaign-level negative keywords from a reviewed CSV
import csv, sys
from google.ads.googleads.client import GoogleAdsClient
def run(cid, csv_path, commit=False):
client = GoogleAdsClient.load_from_storage("google-ads.yaml")
svc = client.get_service("CampaignCriterionService")
ga = client.get_service("GoogleAdsService")
ops = []
for row in csv.DictReader(open(csv_path)): # columns: campaign_id,term,approved
if row["approved"].strip().lower() != "yes":
continue # only human-approved rows
op = client.get_type("CampaignCriterionOperation")
cc = op.create
cc.campaign = ga.campaign_path(cid, row["campaign_id"])
cc.negative = True
cc.keyword.text = row["term"]
cc.keyword.match_type = client.enums.KeywordMatchTypeEnum.EXACT
ops.append(op)
req = client.get_type("MutateCampaignCriteriaRequest")
req.customer_id = cid
req.operations.extend(ops)
req.partial_failure = True # one bad term won't block the rest
req.validate_only = not commit
resp = svc.mutate_campaign_criteria(request=req)
print(len(ops), "ops", "validated" if not commit else "committed", resp.partial_failure_error)
if __name__ == "__main__":
run(sys.argv[1], sys.argv[2], commit="--commit" in sys.argv)定时分析:codex exec 只读运行
codex exec 默认只读沙盒,可用 --output-schema 约束输出结构、-o 写入文件(非交互模式):
# 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 输出「建议」而不是「执行」,投手看完再决定是否运行 add_negatives.py –commit。
6 个控制点
| 控制点 | 做法 | 原因 |
|---|---|---|
| 配额 | 合并查询、日报只跑一次 | Explorer 生产帐户每天 2,880 次操作 |
| 金额单位 | cost_micros ÷ 1,000,000 | 避免把 micros 当成元 |
| 写入预检 | validate_only=True 默认 | 失败请求也计配额 |
| 部分失败 | partial_failure=True | 一个坏词不拖垮整批 |
| 人工批准 | CSV 的 approved 列 | 否定词可能误伤有效流量 |
| 凭据 | ADC/密钥管理,不进仓库 | 防泄露 |

配额细节见 API limits and quotas:返回 GoogleAdsFailure 的请求同样计入每日配额,所以预检和重试上限比想象中重要。
给 Codex 的任务模板
- 「读 AGENTS.md。写 report.py:用 search_stream 导出昨日系列数据到 CSV,金额换算为帐户币种单位,附 pytest(mock GoogleAdsService)。」
- 「写 search_terms.py:GAQL 查 30 天零转化、花费 > 20 的搜索词,输出 CSV 并加 approved 列。」
- 「写 add_negatives.py:只处理 approved=yes,默认 validate_only,partial_failure=True,–commit 才提交。」
- 「为三个脚本写 README 和 cron 示例,不要调用真实 API。」
熊猫出海如何用 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 通过 MCP 查数?
可以,MCP 的 search_search 很方便;但定时日报用脚本更稳定、可测试、输出格式固定。两者可以并存。
否定词用 EXACT 还是 PHRASE?
看场景。脚本示例用 EXACT 最保守;要更大范围排除,让投手在 CSV 中指定匹配类型。
日报能覆盖多个帐户吗?
可以,通过经理帐户设置 login_customer_id,循环客户 ID;注意配额。
Codex 会不会把凭据写进代码?
在 AGENTS.md 里明确禁止,并用 .gitignore 和代码审查双重把关。
合规说明:本文所有自动化都应只用于企业自有或已获正式授权的 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 广告投放全流程自动化
- Claude 用 GAQL 自动生成 Google Ads 报表与异常诊断
- Claude 连接 Google Ads 常见报错排查
- Google 开发了 MCP:让 AI 直接操作你的广告投放
- 用 Codex 写 Facebook 广告日报与预算规则脚本(Facebook 篇)
- 谷歌搜索广告预算花不满:展示份额三列诊断
- AI Max 流量怎么识别:{search_term_matchtype}
联系熊猫出海:Google 广告开户 + AI 自动化投放
告诉我们公司主体所在地、行业、目标国家、落地页链接和预计月预算,以及你想先自动化哪一段(报表、搜索词、素材还是建系列)。我们先做资质与落地页预审,再协助企业合规开通自有 Google Ads 帐户,并把 Claude / Codex 接入到你的投放流程。
WhatsApp:+852 5904 8602Telegram:@PANDA0134微信:szcwh99

官方来源
- Google: Google Ads Query Language (GAQL)
- Google: Mutate resources
- Google: API limits and quotas
- Google: Python client library (google-ads)
- Google: Python client library configuration
- Google: Developer token sunset (2026-09-09) and FAQ
- OpenAI: Codex non-interactive mode (codex exec)
- OpenAI: Custom instructions with AGENTS.md
以上官方页面均于 2026-11-16 查阅。API 版本、工具名称与权限要求会变化,请以官方页面为准。

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