Google Ads API 26.2 更新：投放與報表有何變動

As of November 2026，Google Ads API 的 26.2 版本已在 2026 年 11 月 11 日發布，屬不含 breaking changes 的 minor 版本。對日常做 sem 的團隊來說，沒有一項改動會令現有程式碼停止運作，但有幾項會改變素材預設怎樣交出、季節性調整可以套用到哪裡，以及報表某幾個數字由這一天起換了口徑。換口徑而不換報表名，是前後期數字最容易被混在一起比較的地方。

重點摘要

• 26.2 在 2026 年 11 月 11 日發布，官方列明 minor 版本不含 breaking changes，上一個 minor 版本 26.1 在十月推出。
• 影片響應式廣告的文字疊圖自動化在 v26 建立的新廣告預設為開啟，早年版本的預設相反，兩個版本查同一個欄位會得出不同答案。
• Demand Gen 廣告系列可以套用季節性調整，但只覆蓋 YouTube、Display、Gmail 與 Maps 版位，Discover 不受影響。
• 獨特觸及指標新增可以按 customer 資源查詢，並可按廣告格式與網絡類型分段，令同一組觸及數字多了幾種讀法。
• 判斷兩個月的數字能不能比較，先看欄位、預設值與適用範圍有沒有變，再看數字本身。

這次更新改了哪幾塊

Search Engine Roundtable 在 2026 年 11 月 11 日下午 3:45 發布消息，把 26.2 歸納為觸及 assets、campaigns、reporting 與一般性更新四塊。這個分法與官方 release notes 的分類一致，其中三塊直接落在平日交付的工作上，另一塊是授權流程的錯誤碼。

官方 release notes 對這個版本的定義寫得很清楚：minor 版本不含 breaking changes。這句話的意思是現有的呼叫不會因為升級而失敗，並不代表回傳的內容一模一樣。26.1 在十月推出，之前是 major 版本，同樣在十月，兩個版本相隔一個月；再往前的版本也大致按月安排，改版節奏穩定，反而令「上次檢查是幾時」變成一個需要記錄的項目。以下四節逐項說明會影響日常操作的部分。

影片響應式廣告的文字疊圖預設值

AssetAutomationType 新增了 OVERLAY_TEXT_ON_VIDEOS 這個 enum value，作用是將關聯文字素材（例如標題）的文字疊加在影片素材之上。設定位置在 AdGroupAd.ad_group_ad_asset_automation_settings 欄位，對象是 Demand Gen 的影片響應式廣告。

這裡有一條要分清楚的分界線。在 v26 建立的新 Demand Gen 影片響應式廣告，這個設定預設為 OPTED_IN；而在更早的 API 版本建立的新廣告，預設為 OPTED_OUT。如果你用 v26 之前的版本查詢這個設定，API 會回傳 UNKNOWN，因為那個版本根本不認得這個值。

同一個帳戶，用兩個版本的 API 去讀同一批廣告，一個答「已開啟」，一個答「未知」，第三個答「已關閉」。三個答案都正確，因為它們各自在回答自己版本的問題。任何一份寫著「自動化開啟率」的報表，如果不註明讀取時用的版本，數字就無法與另一份報表對照。

Demand Gen 的季節性調整與它的邊界

Demand Gen 廣告系列現在可以套用 BiddingSeasonalityAdjustment（Advertisement 出價用的季節性調整資源），屬 beta 功能。當 scope 設為 SeasonalityEventScope.CAMPAIGN，你可以在 campaigns 欄位指定 Demand Gen 廣告系列的資源名稱；當 scope 設為 SeasonalityEventScope.CHANNEL，則可以在 advertising_channel_types 欄位指定 AdvertisingChannelType.DEMAND_GEN。

適用範圍有一條明確的界線。Demand Gen 的季節性調整適用於 YouTube、Display、Gmail 與 Maps 版位，對 Discover 版位沒有作用。促銷期把需求預測調高，Discover 的投放並不會跟著調整，同一個廣告系列在不同版位的表現差距會因此擴大，而報表上看不出是哪個版位造成的。

做促銷的客戶如果同時跑搜尋與 Demand Gen，這裡要養成一個習慣：季節性調整的日期範圍、scope 與指定版位寫在同一張表上，與預算變更紀錄放在一起，日後回看某個星期的轉化異常，先確認那一週有沒有季節性調整生效。這也是把 google ad 廣告 的預算與版位紀錄分開存放時最容易出錯的地方。

Google Ads API minor release：agency 要調整的 assets、campaigns、reporting

這是本文與其他版本介紹不同的地方：把這次更新當成一次口徑變更事件來處理。素材、廣告系列與報表三塊各有具體動作，做完與否，決定了下一個月的數字能不能與上月對比。

報告部分有兩組改動。第一組是獨特觸及指標（Metrics.unique_users 等）擴展支援 customer 資源，除原有的 campaign 資源之外也可以查詢；同時新增按 Segments.ad_format_type、ad_sub_format_type、ad_network_type 與 ad_sub_network_type 分段，在 campaign 與 customer 資源上都可以用。第二組是報告新增 hotel booking itinerary 與 vertical ads 分段的支援，包含 advance_booking_window、length_of_booking、start_date 等分段，並新增 Metrics.cross_device_conversions 指標與多個轉化拆分分段搭配使用。

第二組附帶一條會令查詢直接失敗的規則：查詢 campaign、ad_group 或 customer 資源時，如果選用 Segments.geo_target_country 而沒有搭配 hotel booking itinerary 或 vertical ads 分段，會回傳 QueryError.REQUIRED_SEGMENT_FIELD_MISSING 錯誤。舊查詢在升級之後可能第一次跑就報錯，原因不在資料，在分段組合。

判斷兩個月的數字能不能直接比較，我用一個簡單的檢查順序：先問這個數字來自哪個欄位，再問該欄位的預設值有沒有變，然後問它的適用範圍有沒有變，最後才看數字。三題之中有一題答案不同，兩個數字就不同類，放在同一張趨勢圖上會誤導人。

跨版本匯出的數字為甚麼會對不上

一個常見場景：報表工具每月最後一天跑一次全帳戶匯出，負責人年中換了 API 版本，年終做同比，發現觸及人數與去年同月相差很遠。變動來源最少有三處：影片文字疊圖自動化令素材組成不同、獨特觸及指標多了分段與資源選擇、部分查詢因分段規則而少了一批資料。

要查清楚，靠的是保留版本與日期兩項記錄。每一次匯出留下當時的 API 版本、查詢語句與執行日期，出問題時可以重跑同一條查詢，而不是憑記憶推測。這也是我在設計報表時最堅持的一點：數字旁邊要有它自己的出生證明。

變化本身不是問題，變化沒有被記錄才是。26.2 沒有 breaking changes，反而容易令人放鬆，以為不需要做任何事。

Topkee 怎樣處理 API 層的變動

Topkee 的效益型 Google 廣告代運營，覆蓋搜尋廣告、GDN、Performance Max、YouTube、購物與再營銷，並提供開戶、關鍵詞研究、AI 創意製作、數據歸因與週期報告的端到端服務。這次更新分別落在 assets、campaigns 與 reporting 三塊，正好是這條服務線的交付面，所以版本變動對團隊來說是一份要逐項核對的工作清單。這個更新同時也帶來行為上的變動，內部檢查表要一早寫好。

素材層對應智能素材優化方案的做法：按主題產出素材，再按 ROAS 汰換低效主題。素材自動化的預設值一改，素材的實際組成也跟著改，重製規格時要把這一項寫進檢查表。廣告系列層對應搜尋廣告優化的日常工作，細化匹配類型、拓展長尾關鍵詞、更新否定關鍵詞、把預算由低效廣告組轉向高轉化廣告組，這些動作都在 campaigns 層發生。賬戶設置與工作流則負責開戶、創意製作與上線，平台規格更新後要同步調整上線流程。

報表層是這次最需要小心的地方。廣告效能分析與週期報告以標籤數據把廣告主題與平台關聯，成交後回填金額計算各主題與平台成效，週期報告包含廣告報告、轉化報告與 ROI 報告。reporting 欄位一變，這幾份報告的口徑就要逐張重看。可引用的成效案例亦要按同一個原則處理，舊案例的數字註明當日讀取的欄位與日期，新人接手時才不會把它當成今天的基準。

Topkee 的做法是把對帳的起點放在客戶自己的數據層。TTO CDP 的廣告數據接入在 Advertising 分類下設有 Google Ads Lead Form Webhook 與 Google Ads Call Details，後者基於 google search_stream API 把通話明細匯入 CDP；Google 廣告亦經 TTCLID 串接跨渠道、跨裝置接觸點，形成單一事實來源。平台後台的報表會隨版本改口徑，客戶數據層保留的原始事件不會，兩邊對照才知道差異是來自實際成效，還是來自欄位定義變了。客戶直接查 效益型 Google 廣告代運營 的介紹頁，可以看到這條服務線覆蓋的範圍。

檢查清單：今日可以自己跑的四項

1. 向代理商或內部技術負責人索取目前使用的 API 版本，以及下一次升級的計劃日期。
2. 抽三份近月的週期報告，逐項核對數字旁邊有沒有註明查詢用的欄位與版本。
3. 檢查含 Segments.geo_target_country 的查詢有沒有同時選用酒店預訂或 vertical ads 分段。
4. 記錄現時 Demand Gen 廣告系列有沒有套用季節性調整，以及調整涵蓋哪些版位。

系列結構的變動，參考 GDN 與 AI 功能的更新紀錄

這次 campaigns 層的改動集中在 Demand Gen 與季節性調整，同一時間其他廣告產品線也在改。Topkee 的 GDN 廣告服務頁 說明展示網絡的投放方式，而 Weber 平台的功能更新紀錄 則記錄了平台功能的調整時間。兩類紀錄放在一起看，就能區分哪些變動來自 Google 的 API，哪些來自自家工具。

向客戶解釋關鍵 字 廣告的成效時，同一組數字往往有多個版本：平台後台一份、代理商報表一份，客戶 CRM 又有一份。在核對google ad 廣告的成效之前，先確認各份讀的是同一個欄位、同一段時間與同一個版本，否則比較的不是成效，是定義。

google ad 廣告 的素材規格要跟著版本走

素材自動化的預設值改變之後，同一批影片素材在舊版本與新版本下的實際呈現不同。做 google ad 廣告 的素材檢視時，把自動化設定一併截圖存檔，日後比較素材表現，才有條件判斷差異來自創意本身還是來自設定。

常見問題

Google Ads API 26.2 會不會令現有的 API 呼叫失效

不會。官方 release notes 列明 minor 版本不含 breaking changes。但回傳內容與預設值可能有變，例如舊版本查詢文字疊圖設定會得到 UNKNOWN，所以升級後仍要逐項核對報表數字。

影片響應式廣告的文字疊圖是預設開啟的嗎

視乎建立廣告時用的版本。在 v26 建立的新 Demand Gen 影片響應式廣告預設為 OPTED_IN，在更早的 API 版本建立的預設為 OPTED_OUT。審核素材時要一併查看這個設定。

Demand Gen 的季節性調整覆蓋哪些版位

適用於 YouTube、Display、Gmail 與 Maps 版位，對 Discover 版位沒有作用。促銷期只調整 Demand Gen 的需求預測，Discover 的投放不會跟著變。

為甚麼升級之後有些報表查詢會報錯

如果查詢 campaign、ad_group 或 customer 資源時選用了 Segments.geo_target_country，但沒有搭配 hotel booking itinerary 或 vertical ads 分段，查詢會回傳 QueryError.REQUIRED_SEGMENT_FIELD_MISSING。補上所需分段即可。

我應該等 Google 在開發者網誌公布之後才處理嗎

可以等，但要有記錄。Search Engine Roundtable 指出 Google 當時尚未在開發者網誌公布，而 release notes 已經上線。處理與否是資源分配問題，知不知道版本已經生效才是判斷前提。

Sources

1. Barry Schwartz, "Google Ads API Version 26.2 Now Out Available", Search Engine Roundtable, 2026-11-11. https://www.seroundtable.com/google-ads-api-version-262-42517.html
2. "Google Ads API release notes — v26.2 (2026-11-11)", Google for Developers, 2026-11-11. https://developers.google.com/google-ads/api/docs/release-notes#v26-2-2026-11-11