Google Ads Explorer Access 完整教學：免審核取 token 到 GAQL 實戰（含 v23 踩雷）
Google Ads Explorer Access（2026-02 推出）讓 production 帳號取 developer token 免正式審核、多數自動審批，額度約 2,880 ops/日，唯讀 GAQL searchStream 報表足夠（受限或寫入才升 Basic／Standard）。取 token 需先把帳號設為 Manager Account（MCC）、進 API Center（ads.google.com/aw/apicenter），token 務必存密鑰管理、不落 repo。實作三個關鍵：① MCC 操作必帶 login-customer-id 標頭（去連字號）；② v23 禁止 SELECT 比率指標 conversions_value_per_cost（PROHIBITED_METRIC），要改拉轉換價值與花費自己算 ROAS；③ cost 是 micros 要除以 1,000,000。Admetry 已用真實帳號驗證這條串接，再由 Gemini 產出洞察，台灣代理商不必自己踩 v23 的雷。
Google 在 2026-02 推出 Explorer Access：production 帳號取 Google Ads API 的 developer token 免正式審核（多數自動審批），不用再卡在過去動輒數天的申請佇列。我們最近就用它把 Google Ads 連接器從「能力就緒」推到「真實拉到客戶數字」，過程還被 v23 的一個禁用指標真踩了一次。整條路與踩雷寫給代理商。
Explorer Access 和舊申請差在哪
過去要拿 developer token，得填正式申請表、落審批佇列，遇到積壓可能等好幾天。Explorer Access（2026-02）讓 production 帳號的存取多數自動核准，額度約 2,880 ops/日——對唯讀報表（GAQL `searchStream`）綽綽有餘。只有受限欄位或寫入操作才需要再升 Basic / Standard。
取 token：先有 MCC 才有 API Center
關鍵前提：你的 Google Ads 帳號要先是（或建立一個）Manager Account（MCC），才看得到 API Center。
- 登入 Google Ads → 若還不是 MCC，先建立管理員帳戶。
- 進 API Center（`ads.google.com/aw/apicenter`）。
- 申請 developer token，多數會直接是 Explorer 層級。
- token 絕不寫進 repo 或前端——存進密鑰管理（我們放 GCP Secret Manager），程式只在執行時讀。
若被導去填正式申請表、落到審批佇列，就照實標記等待、先用其他平台收尾，別硬等也別造假。
打 GAQL searchStream 的實際細節
報表查詢走 `POST /customers/{customer_id}/googleAds:searchStream`，base 是 `https://googleads.googleapis.com/{版本}`。兩個代理商最容易漏的點：
- login-customer-id 標頭（MCC 必填）：用 MCC 操作子帳號時，必須帶 `login-customer-id` 標頭，值是 MCC 的 customer id 去掉連字號。漏了會被拒。
- 別讓任意 GAQL 字串被覆蓋：我們把查詢鎖成 campaign / ad_group / ad 三層白名單，由設定選層級，而不是讓使用者塞任意 GAQL——避免注入與不可控欄位。
v23 真實踩雷：禁止 SELECT 比率指標
這是我們 2026-06-15 真打 API 才揪出的：Google Ads API v23 不允許在 SELECT（或 WHERE）直接查比率型指標，例如 `metrics.conversions_value_per_cost`、`metrics.all_conversions_value_per_cost`，會回 `PROHIBITED_METRIC_IN_SELECT_OR_WHERE_CLAUSE`。
解法不是放棄 ROAS，而是改拉組成項自己算：SELECT 轉換價值（`metrics.conversions_value`）與花費（`metrics.cost_micros`），在程式端算 `ROAS = 轉換價值 ÷ 花費`。順帶一提，cost 是 micros（百萬分之一單位），要除以 1,000,000 還原成幣別金額——這也是常見對不上後台的原因。跨平台把這個 ROAS 放進同一張表前，記得先對齊口徑（見跨平台歸因與重複計算陷阱）。
代理商串接 checklist
- 帳號先成 MCC 才有 API Center；token 走 Explorer 免審批、唯讀夠用。
- token 進密鑰管理，grep repo 應為 0，不落程式碼。
- MCC 操作必帶 `login-customer-id`（去連字號）。
- 別 SELECT `*_value_per_cost` 比率指標，拉組成項自己算 ROAS。
- `cost_micros` 記得 ÷ 1,000,000。
- GAQL 鎖白名單層級，不開放任意查詢字串。
常見問題（FAQ）
Q：Explorer Access 要正式申請嗎？ A：多數 production 帳號自動審批、不需正式核准，額度約 2,880 ops/日，唯讀報表足夠；受限或寫入功能才需升級。
Q：為什麼我 SELECT ROAS 比率指標會報錯？ A：v23 禁止在 SELECT／WHERE 用 `*_value_per_cost` 等比率指標（PROHIBITED_METRIC）。改拉轉換價值與花費自己算。
Q：用 MCC 拉子帳號一直被拒？ A：多半漏了 `login-customer-id` 標頭，或值沒去掉連字號。
想把 Google Ads 串接從「能跑」推到「數字對得上後台」？可以先 [預約免費廣告健檢](/free-audit)，我們用真實帳號核對你的 GAQL 口徑與 ROAS 計算。