2026 年 9 月 23 日，星期三
今天我們宣布推出 Google Ads API 25.2 版。如要使用新功能，請務必升級用戶端程式庫和用戶端程式碼。所有更新後的用戶端程式庫和程式碼範例都已發布。
歡迎參加明天 (美東時間 9 月 24 日上午 10 點) 舉辦的 Discord Google Ads API 版本重點活動或 Ads Developers YouTube 直播，我們將在活動中逐步介紹這個版本。我們也會錄製活動內容並發布到 YouTube，方便無法參加現場直播的使用者觀看。如有任何疑問或想討論這篇文章，歡迎透過 Discord 的 #ads-api 頻道與我們聯絡。
新功能
以下是 25.2 版的重點更新內容：
- 競爭基準百分位數指標：
BenchmarksService.GenerateBenchmarksMetrics現在會使用PercentileMetrics和BenchmarksCustomerPercentileTier，以百分位數級別格式顯示您與其他廣告主之間的競爭地位指標。如要要求這項資料，請將PERCENTILE_DATA新增至supplemental_data，將benchmarks_source設為ALL_ADVERTISERS，並指定category_filter。 - 從智慧廣告活動產生最高成效廣告活動草稿：您可以使用新的
SmartCampaignSettingService.GeneratePMaxDraftCampaign方法，直接從現有的智慧廣告活動，以程式輔助方式產生最高成效廣告活動草稿，簡化廣告活動升級工作流程。 - 素材資源群組網址選項：您現在可以直接在
AssetGroup的素材資源群組層級，為最高成效廣告活動設定追蹤範本 (tracking_url_template)、自訂參數 (url_custom_parameters) 和最終到達網址尾碼 (final_url_suffix)。 - 依 YouTube 頻道帳號代碼取得創作者洞察資料：
ContentCreatorInsightsService.GenerateCreatorInsights現在除了頻道 ID 外，也支援直接依 YouTube 頻道帳號代碼搜尋，簡化創作者探索流程。 - 垂直廣告行程維度和價格競爭力：我們為飯店和旅遊廣告主新增了行程維度區隔 (
advance_booking_window、length_of_booking、start_date、start_day_of_week、user_set_dates)，以及新的垂直廣告指標和區隔，例如vertical_ads_price_difference_percentage、vertical_ads_price_tier和vertical_ads_potential_impressions。 - 搜尋出價調整建議：如果搜尋廣告活動的目標單次轉換出價或目標廣告投資報酬率出價過低，無法參與競價，系統會顯示新的最佳化建議 (
raise_target_cpa_performance_bid_too_low_recommendation和lower_target_roas_performance_bid_too_low_recommendation) 通知您。
開始使用
Google Ads API 25.2 版是 25 版的直接升級版。如果您使用我們的用戶端程式庫，請下載最新版本，開始使用這些功能。如需完整異動清單，請參閱官方版本資訊。如有任何疑問，或想討論這篇文章，歡迎前往 Google 廣告與評估社群 Discord 伺服器與我們聯絡。
如有技術支援問題，請聯絡 Google Ads API 支援管道。
- Anash P. Oommen，Google Ads API 團隊
標籤： google-ads-api、 release