最後更新:2026-11-16(Google Ads API、Anthropic、OpenAI 官方文件皆於當天查閱;目前 API 版本 v26.2)
2026 年 Google Ads API 最大的變化,是開發人員權杖在 2026-09-09 停用。現在 API 存取等級屬於 Google Cloud 專案——也就是擁有你 OAuth 用戶端或服務帳戶的那個專案;請求標頭裡繼續送權杖也只會被忽略(官方說明)。這對用 Codex 做自動化的團隊來說,是重新設計權限的好時機。
四個存取等級
| 存取等級 | 可存取 | 每日操作上限 | 怎麼取得 |
|---|---|---|---|
| Test | 僅測試帳戶 | 15,000 | 啟用 Google Ads API 自動取得 |
| Explorer | 測試+正式帳戶 | 正式帳戶 2,880;測試帳戶 15,000 | Cloud Console 申請,多數自動核准 |
| Basic | 測試+正式帳戶 | 15,000 | 需品牌驗證後申請 |
| Standard | 測試+正式帳戶 | 不限 | 申請,審核約 10 個工作天 |

Explorer 足以讓多數團隊開始做基本自動化,但它限制帳戶建立(CustomerService.CreateCustomerClient)、使用者管理、規劃類服務(KeywordPlanIdeaService、ReachPlanService 等)以及帳單與付款相關服務;需要時再申請 Basic 或 Standard(存取等級)。新申請 Basic、Standard 需要先完成 Google Cloud 專案的品牌驗證。
建議的專案結構
- dev 專案(Test 等級):Codex 日常開發、跑測試,只能碰測試帳戶。測試帳戶在後台顯示為已取消、沒有帳單、不會投放廣告(
- 測試帳戶
- )。
- prod 專案(Explorer 或以上):只給定時報表與經核准的寫入腳本使用,憑證由專人保管。
- 這樣即使 dev 環境的 Codex 寫錯程式,也物理上碰不到正式帳戶。若誤用 Test 專案呼叫正式帳戶,v25 起會回傳
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION。
Codex 端的 6 層設定
| 層級 | Codex 設定 | 建議值 |
|---|---|---|
| 沙盒 | sandbox_mode | 預設唯讀;需要寫檔才用 workspace-write |
| 網路 | workspace-write 預設關閉網路 | 呼叫 API 的步驟由人在沙盒外執行 |
| 核准 | approval_policy | on-request;不要用 never 搭配完整權限 |
| MCP 工具 | enabled_tools/disabled_tools | 只開查詢與素材 |
| 規則 | AGENTS.md | 帳戶白名單、PAUSED、micros |
| 憑證 | 環境變數/ADC | 不進對話、不進 Git |

codex exec 預設在唯讀沙盒執行;workspace-write 沙盒預設關閉網路(Codex 安全與核准)。對 Google Ads 自動化來說,這正好形成分工:Codex 在沙盒裡寫程式與測試,真正呼叫 API 的步驟由人或受控的排程主機執行。
# ~/.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並在 AGENTS.md 寫死規則:
# 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.合規檢查清單
- 只操作企業自有或已正式授權的 Google Ads 帳戶;客戶帳戶透過其管理員帳戶授權,不買、不租、不共用(風險見
- 谷歌广告户、MCC 能买吗?买断户风险
- )。
- 遵守《Google Ads API 條款》與配額(
- API 條款
- 、
- 配額
- )。
- 所有寫入先 validate_only,新廣告活動一律 PAUSED。
- 廣告內容遵守 Google Ads 政策;受限產業由人工審核(
- Google Ads 政策
- )。
- OpenAI 服務僅在支援國家/地區提供,請由支援地區的合法主體開通(
- OpenAI 支援地區
- )。
沒有開發人員權杖後,舊程式要改嗎?
不用改也能跑:權杖變成可選且會被忽略,原有的存取等級已依停用前 90 天的 API 使用紀錄自動轉移到 Google Cloud 專案。但建議讓 Codex 順手把設定檔中的 developer_token 移除、加上註解,避免新同事誤以為還需要申請。唯一例外是 App Conversion Tracking API,仍需從 API Center 申請權杖。
熊貓出海如何用 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 廣告開戶與代操(熊貓出海服務頁)。
常見問題
Explorer 申請要多久?
Google 表示多數情況會自動審核並核准;Standard 審核通常約 10 個工作天。
Codex 可以幫我申請存取等級嗎?
申請在 Google Cloud Console 的 Google Ads API 總覽頁完成,屬於帳戶管理動作,建議由專案負責人親自操作。
測試帳戶能測報表嗎?
可以測查詢語法,但測試帳戶沒有投放資料,報表會是空的。
Codex 雲端任務適合跑 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 的政策合規與帳戶安全
- Claude 連結 Google Ads:OAuth、存取等級與經理帳戶疑難排解
- Google 開發了 MCP,讓 AI 直接操作你的廣告投放
- Codex 自動化 Facebook 廣告的權限、沙盒與合規(Facebook 篇)
- AI Token 是什麼?
聯絡熊貓出海:Google 廣告開戶 + AI 自動化投放
請告訴我們公司登記地、產業、目標國家、到達網頁連結與預估月預算,以及想先自動化哪一段(報表、搜尋字詞、素材或建立廣告活動)。我們先做資格與到達網頁預審,再協助企業合規開通自有 Google Ads 帳戶,並把 Claude / Codex 接入你的投放流程。
WhatsApp:+852 5904 8602Telegram:@PANDA0134WeChat/微信:szcwh99

官方來源
- Google: Developer token sunset (2026-09-09) and FAQ
- Google: Google Ads API access levels
- Google: Test accounts
- Google: Google Ads API Terms and Conditions
- Google: API limits and quotas
- Google Ads policies (Advertising Policies Help)
- OpenAI: Codex agent approvals & security
- OpenAI: Codex non-interactive mode (codex exec)
- OpenAI: Codex configuration reference
- OpenAI: Custom instructions with AGENTS.md
- OpenAI: Supported countries and territories
以上官方頁面皆於 2026-11-16 查閱。API 版本、工具名稱與權限要求會變動,請以官方頁面為準。

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