Google Ads API v20 完整解析：你該知道的重點功能

Google Ads API v20 是首個原生支援 AI Max 控制項、資產庫寫入功能以及全新搜尋字詞洞察端點的版本，同時也正式淘汰了一些已棄用兩年的舊版服務。如果你是大規模操作者，遷移到 v20 是必要之舉。已棄用的 v17 及更早版本的端點將在公布的終止服務日期停止回傳資料。

v20 新功能

主要新增項目包括 SearchTermInsightService、AssetLibraryService 的寫入方法、AiMaxAdGroupService，以及擴充後的 RecommendationService，後者現在能以程式化方式公開先前僅在 UI 中顯示的建議。此外，還有更豐富的實驗中繼資料欄位，以及一個專用的 ConversionActionService.upload_offline_conversions v2 方法，支援新的識別碼格式。

你必須處理的棄用項目

舊版的 AdGroupAdAssetView、使用純文字電子郵件字串的原始 Customer Match 上傳方法，以及關鍵字出價模擬器的 v17 報表欄位均已退役。仍在引用這些項目的程式碼在 v20 中將回傳錯誤。遷移過程雖然機械化但相當繁瑣。請為每個中型整合預留一週的工作時間。

AI Max 控制項

AiMaxAdGroupService 終於公開了過去僅限 UI 操作的廣告活動層級 AI Max 行為切換開關。你可以為每個廣告群組設定資產參與層級、品牌排除清單、地理位置排除覆寫以及轉換時間範圍覆寫。這使得 AI Max 能夠在需要預算護欄的企業級技術堆疊中使用。

資產庫寫入

AssetLibraryService 現在支援程式化上傳、標記以及跨多個廣告活動的資產重複使用。結合 AssetGroupService，這讓你能夠從自己的 DAM 系統端到端地佈建 Performance MaxiGoogle Ads 廣告活動類型，利用機器學習自動將預算分配至搜尋、多媒體、YouTube、Gmail 和地圖。了解更多詞彙解釋 → 廣告活動。上傳的資產會遵循與 UI 上傳相同的內容審核佇列，因此資產在建立後不會立即開始投放。

從 v19 及更早版本的遷移路徑

Google 保證每個主要版本有 14 個月的終止服務窗口。v17 將於 2026 年終止服務，v18 於 2026 年第四季，v19 於 2027 年。支援的遷移路徑是直接從 v17 遷移到 v20，而不是 v17 → v18 → v19 → v20。如果你跳過版本，就必須逐一重新測試每個端點。我們建議每 12 個月為一個主要版本進行一次遷移衝刺，而不是每 4 年進行一次馬拉松式遷移。

需要 SEO 安全的內容策略？

我們的團隊建構內容策略，在利用 AI 效率的同時，維持 Google 所獎勵的品質、專業知識和原創性。打造既能排名又能轉換的內容。