版本資訊

如要查看目前和預計淘汰的功能清單，請參閱「功能淘汰」。

v26 主要版本

Google Ads API 26 版包含下列新功能、更新和破壞性變更。

v26 (2026-10-14)

Google Ads API v26 是主要版本，新增了下列功能、更新和破壞性變更。

如需相關指引，請參閱「升級至最新版本」。

破壞性變更

初始狀態 新狀態 變更類型 實作指南
廣告活動
LocalServicesPmaxCampaignSettings 中的選用 country_code 欄位 建立在地生活服務最高成效廣告活動時的必填欄位 (LocalServicesPmaxCampaignSettings.country_code) 行為改變 建立區域服務最高成效廣告活動時，請務必指定 country_code (以及新規定listing_id)。
轉換
ConversionTrackingSetting (Customer.conversion_tracking_setting) 中的 enhanced_conversions_for_leads_enabled 欄位 無 移除 請改用 ConversionTrackingSetting.enablement_setting 檢查Customer.conversion_tracking_setting帳戶層級的強化轉換設定。
指定目標
AdGroupBidModifier 中的飯店專屬條件欄位：
  • hotel_date_selection_type
  • hotel_advance_booking_window
  • hotel_length_of_stay (min_nights和max_nights)
  • hotel_check_in_day
  • hotel_check_in_date_range
 AdGroupBidModifier 中不限產業的條件欄位： 重新命名 / 移除 更新參照，改用不限產業的條件欄位，支援指定飯店以外的旅遊產業 (例如「待辦事項」)。條件 ID、指定行為和現有出價調節係數則維持不變。min_nights 和 max_nights 的值會原封不動地沿用至 min_days 和 max_days。
HotelDateSelectionType 和 segments.user_set_dates 類型 DateSelectionType 重新命名 / 變更類型 使用 DateSelectionType，而不要使用 HotelDateSelectionType。
CriterionError 中飯店專屬錯誤原因：
  • HOTEL_LENGTH_OF_STAY_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_CHECK_IN_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_CHECK_IN_DATE_RANGE_START_DATE_TOO_EARLY
  • HOTEL_CHECK_IN_DATE_RANGE_END_DATE_TOO_LATE
  • HOTEL_CHECK_IN_DATE_RANGE_REVERSED
 CriterionError 中與產業無關的錯誤原因： 重新命名 更新錯誤處理程序，檢查新的不限產業錯誤原因。

功能和更新 (非破壞性)

功能與更新 類型 說明
素材資源
LINE 和簡訊商業訊息供應商 新欄位和列舉值 在 BusinessMessageAsset 中新增對 LINE 和簡訊的支援，包括新欄位 BusinessMessageAsset.line_info 和 BusinessMessageAsset.sms_info，以及 BusinessMessageProvider.LINE 和 BusinessMessageProvider.SMS。
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY 新的列舉值 / 錯誤 在 AssetGroupError 中新增，指出 GoogleLocalServicesInfo (AssetGroup.google_local_services_info) 中指定的類別不支援在地生活服務最高成效廣告活動。
廣告活動
建立在地生活服務最高成效廣告活動 新功能、欄位和錯誤

PmaxCampaignSettings.local_services_enabled 從 OUTPUT_ONLY 更新為 IMMUTABLE，允許外部 API 用戶端在建立新的在地生活服務最高成效廣告活動時指定 local_services_enabled = true。

此外，我們也新增了 LocalServicesPmaxCampaignSettings.listing_id，可顯示連結至在地生活服務最高成效廣告活動的 Google 商家檔案 ID (在建立在地生活服務最高成效廣告活動時標示為「必要」)，並新增 CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID 錯誤代碼。
在地生活服務廣告活動驗證錯誤 新的列舉值和錯誤 在地生活服務廣告活動新增驗證錯誤：
驗證 Hotel Center 帳戶連結 新的列舉值 / 錯誤 在 CampaignError 中新增 CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED 錯誤代碼，指出將飯店房源素材資源組合 (Campaign.hotel_property_asset_set) 連結至旅遊目標專用的最高成效廣告活動時，必須有有效的 Hotel Center 帳戶連結。
需求開發廣告活動每日最低預算 新欄位 在 CurrencyConstant 中新增 demand_gen_info.minimum_budget_per_day_micros 欄位，指定需求開發廣告活動以該幣別計價時，每日最低預算。當 API 強制執行的最低預算變更時，這個欄位的值就會更新。
廣告活動的品牌提升評估設定 新欄位 新增 Campaign.lift_measurement_config，公開與廣告活動連結的升幅評估設定資源名稱。
AI Max 實驗驗證 新的列舉值 / 錯誤 嘗試為已啟用 AI Max 的廣告活動 (或在建立實驗組前，於同一要求中啟用 AI Max) 建立 ADOPT_AI_MAX 實驗時，ExperimentArmError 會傳回 ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED 錯誤代碼。
購物廣告活動產品資訊類型 擴大支援 擴大支援購物廣告活動的Campaign.listing_type。
歐盟政治廣告自主聲明更新 更新行為和新欄位

對於不指定歐盟地區的廣告活動，Campaign.contains_eu_political_advertising 現在為選用屬性。
轉換
整合式強化轉換設定 新欄位和列舉 新增 ConversionTrackingSetting.enablement_setting 和 ConversionTrackingSetting.effective_enablement_setting (位於 Customer.conversion_tracking_setting)，公開帳戶的統一強化轉換設定，並以新的 EnhancedConversionsConfig 列舉表示。
ConversionActionCategory.MESSAGE_LEAD 新的列舉值 ConversionActionCategory 新增了這項功能，可支援訊息或即時通訊互動，表示對廣告主產品/服務感興趣。
ConversionAttributionEventType.CLICK 新列舉值 已新增至 ConversionAttributionEventType，代表歸因於廣告點擊的轉換，先前包含在 UNKNOWN 列舉值中。
一般
在地生活服務待開發客戶更新 新欄位和列舉值
建議
提高搜尋預算最佳化建議 新建議 新增 RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW、Recommendation.raise_budget_performance_too_low_recommendation 和 ApplyRecommendationOperation.raise_budget_performance_too_low，支援在搜尋廣告活動每日預算過低時提高預算。
報表
搜尋提升評估 新功能、資源、區隔和指標 新增搜尋提升評估支援：
購物廣告活動的最終到達網址擴展素材資源檢視 擴大支援 擴充 final_url_expansion_asset_view 以支援購物廣告活動 (ad_group 可與 final_url_expansion_asset_view.ad_group 一起選取為歸因資源)。
影片
YouTube 生成式內容揭露資訊 新欄位和列舉 新增對 YouTube 上傳內容揭露生成式內容的支援。VideoContentMetadata 類型的新欄位 YouTubeVideoUpload.video_content_metadata 已新增至 YouTubeVideoUpload，其中包含 YouTubeVideoUploadGenerativeContentDisclosure 類型 VideoContentMetadata.generative_content_disclosure 下的揭露設定。

v25 主要和子版本

Google Ads API 第 25 版包含下列新功能、更新和破壞性變更。

v25.2 (2026-09-23)

Google Ads API 25.2 版新增了下列功能和更新。子版本 (例如 v25.2) 不含破壞性變更。

功能與更新 類型 說明
素材資源
「AssetGroup」的網址選項 新欄位 新增AssetGroup網址選項支援功能，讓廣告主在素材資源群組層級指定追蹤範本、自訂參數和最終到達網址尾碼：
廣告活動
自動影片檢索資訊 新欄位和列舉 在 Campaign.AssetAutomationSetting 中新增 AutomatedVideoCrawlSetting 和 AssetAutomationType.AUTOMATED_VIDEO_CRAWL，以便指定最高成效廣告活動的自動影片檢索設定。AutomatedVideoCrawlSetting.automated_video_crawl_infos 包含 AutomatedVideoCrawlInfo 項目清單，每個項目都會設定檢索 url、source_platform (VideoCrawlSourcePlatform：LANDING_PAGE、SOCIAL 或 YOUTUBE) 和 enabled 選擇加入狀態。
顧客生命週期最佳化價值倍增器錯誤 新的列舉值和錯誤 新增設定顧客生命週期最佳化價值調節係數 (value_multiplier 和 high_lifetime_value_multiplier) 時的驗證錯誤原因：
SmartCampaignSettingService.GeneratePMaxDraftCampaign 新功能 新增 SmartCampaignSettingService.GeneratePMaxDraftCampaign，支援從現有智慧廣告活動產生最高成效廣告活動草稿，並將狀態初始化為 CampaignStatus.PAUSED，建立狀態則為 CampaignCreationStatus.INCOMPLETE (請參閱「將智慧廣告活動轉換為最高成效廣告活動」)：
轉換
Firebase 廣告曝光 新的轉換動作類型和類別 公開 FIREBASE_ANDROID_APP_AD_IMPRESSION 和 FIREBASE_IOS_APP_AD_IMPRESSION 轉換動作類型，方便您擷取及修改這些轉換動作。此外，也公開 IN_APP_AD_REVENUE 類別，方便您在 ConversionActionCategory 中追蹤應用程式內廣告營利收益。
一般
BusinessProfileLocationSyncError 新列舉和錯誤 新增在 LOCATION_SYNC 類型的 AssetSet 中同步處理地點時，商家檔案地點同步處理錯誤的原因。API 現在會傳回 BusinessProfileLocationSyncError 和特定原因 (EMAIL_INVALID、OAUTH_TOKEN_INVALID、ACCOUNT_REMOVED 和 NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT)，而非傳回一般 UNKNOWN 錯誤。
規劃
BenchmarksService.GenerateBenchmarksMetrics 百分位數指標 新功能

更新 BenchmarksService.GenerateBenchmarksMetrics，以百分位數層級格式提供指標，代表顧客在其他廣告主中的競爭地位。指標會以 PercentileMetrics 傳回至新的 CustomerMetrics.percentile_metrics 欄位 (GenerateBenchmarksMetricsResponse.customer_metrics 和 BreakdownMetrics.customer_metrics)，並以 BenchmarksCustomerPercentileTier 表示。

只有在 GenerateBenchmarksMetricsRequest 中同時符合下列兩項條件時，系統才會填入 CustomerMetrics.percentile_metrics：

新增對 ListBenchmarksAvailableDatesResponse.supported_dates (由 BenchmarksService.ListBenchmarksAvailableDates 傳回) 內未結算季度日期的百分位數指標支援。雖然 supported_dates 中所有日期 (包括未結算季度) 都支援客戶匯總指標 (CustomerMetrics.aggregate_metrics)、客戶比率指標 (CustomerMetrics.average_rate_metrics) 和客戶百分位數指標 (CustomerMetrics.percentile_metrics)，但未結算季度不支援客戶占有率指標 (CustomerMetrics.share_metrics) 和基準來源的比率指標 (average_benchmarks_metrics，例如「/Apparel/Clothing」廣告的 average_cpm)，且會從回應中省略，除非要求的 date_range 落在較窄的 ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics 範圍內。

新增自訂 BenchmarksError.NO_METRICS_FOUND 錯誤，指出找不到所選輸入組合的指標，以提升可用性。
YouTube 頻道帳號代碼，用於取得創作者洞察資料 新功能 ContentCreatorInsightsService.GenerateCreatorInsights 已更新，支援使用 YouTubeChannels.youtube_channel_handles 依 YouTube 頻道帳號代碼搜尋 (有效的頻道帳號代碼必須以 @ 開頭，例如 @channel_handle)。這個選項與依 YouTube 頻道 ID 搜尋類似。回覆包含所要求 YouTube 創作者的洞察資料。
建議
單次轉換出價和廣告投資報酬率出價最佳化建議 新建議 新增 Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) 和 Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW)，以及 ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low 和 ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low，以便在搜尋廣告活動出價過低而無法參與競價時，提高目標單次動作出價或降低目標廣告投資報酬率：
報表
飯店行程維度區隔 新區隔 在 Segments 中新增下列飯店和旅遊預訂行程維度區隔 (可使用 campaign、ad_group 和 customer 選取)：
直向廣告指標 新指標 在 Metrics 中新增下列飯店和旅遊產業廣告報表指標 (可透過 campaign、ad_group 和 customer 選取)：
直向廣告區隔 新區隔 為飯店和旅遊垂直產業廣告報表新增下列區隔 (可使用 campaign、ad_group 和 customer 選取)：Segments

v25.1 (2026-08-19)

Google Ads API 25.1 版新增下列功能和更新。子版本 (例如 v25.1) 不含破壞性變更。

功能與更新 類型 說明
素材資源
AssetFieldType.TEXT_DISCLAIMER
ServedAssetFieldType.TEXT_DISCLAIMER		 新的列舉值 新增文字免責事項素材資源支援。
廣告活動
Campaign.aca_migration_date_time
Campaign.broad_match_migration_date_time		 新欄位 追蹤即將自動遷移至 AI Max 的進度。
轉換
品牌提升評估 新功能 新增品牌提升評估支援，並進行下列更新：
轉換提升評估 新功能 新增轉換提升評估支援，並進行下列更新：
LiftMeasurementFlight 新資源 新的唯讀資源，代表提升評估設定的檔期詳細資料，包括評估檔期的開始和結束日期 (start_date 和 end_date)。
一般
SmartCampaignError 新的列舉值 新增最高成效廣告活動生成限制的特定錯誤代碼：
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION 新的列舉值 / 錯誤 當存取層級為 TEST 的 Google Cloud 雲端專案嘗試對非測試帳戶提出要求時，系統會傳回這項錯誤。
規劃
品牌觀感洞察 新功能 在 ContentCreatorInsightsService 中新增品牌觀感洞察支援：
BenchmarksService 項強化功能 新功能 新增類別篩選條件，可用於縮小基準分析範圍。此外，還支援其他重要的業務指標：
家長狀態指定目標 新功能 觸及規劃工具新增家長狀態指定目標支援。在 ReachPlanService.GenerateReachForecast 服務的 Targeting 中新增 parental_statuses 欄位，並在 ReachPlanService.ListPlannableProducts 服務的 PlannableTargeting 中新增 parental_statuses 欄位。
建議
Recommendation.campaign_specific_app_goal_recommendation 新建議 建議新增廣告活動專屬的應用程式轉換目標。新的 EffectiveAutomaticGoal 資源用於代表這項最佳化建議中的目前目標。
報表
Metrics.original_conversion_value 新欄位 代表可出價轉換的原始轉換價值。這是指未經調整的轉換價值，也就是未套用任何價值規則調整項 (例如轉換價值規則或生命週期目標調整項) 的原有值。
會員忠誠度統計資料 新功能 新增支援功能，可依使用者會員方案狀態劃分統計資料，並為轉換價值規則新增會員方案主要維度：
指定目標
vertical_ads_item_bid 新條件類型 已將新的 vertical_ads_item_bid 條件類型新增至 AdGroupCriterion.criterion。

v25 (2026-07-22)

Google Ads API v25 是主要版本，新增了下列功能、更新和重大變更。

如需操作說明，請參閱「升級至最新版本」。

破壞性變更

初始狀態 新狀態 變更類型 實作指南
廣告活動
CustomerLifecycleOptimizationValueSettings 中的獨立欄位 additional_value 和 additional_high_lifetime_value 分別是 value_adjustment 和 high_lifetime_value_adjustment oneof 的一部分，與新的 value_multiplier 和 high_lifetime_value_multiplier 欄位並列 結構異動 請更新這些欄位的參照，因為這些欄位現在屬於 oneof。
舊版 CustomerLifecycleGoal 和 CampaignLifecycleGoal 資源、對應的服務 CustomerLifecycleGoalService 和 CampaignLifecycleGoalService，以及舊版設定/列舉 (CustomerAcquisitionGoalSettings、CustomerAcquisitionOptimizationModeEnum、LifecycleGoalValueSettings) 無 移除 使用改版後的統一目標架構：
一般
獎勵服務要求和回應訊息中的巢狀列舉欄位：
  • FetchIncentiveRequest.type
  • Incentive.type
  • IncentiveOffer.type
 獨立列舉欄位： 重新命名 / 移除 請改用新的獨立列舉欄位，而非舊版 type 欄位。
ApplyIncentiveRequest 中的選用 selected_incentive_id 和 customer_id 欄位 必填欄位 行為改變 呼叫 ApplyIncentive 時，請務必提供這兩個欄位。
LocalServicesLead 資源中的消費者電子郵件地址欄位 ContactDetails.email 無 移除 請移除這個欄位的參照，因為系統已不再支援。
AdvertisingPartnerLinkInvitationProperties 中的選填 allowed_domain 欄位 為廣告合作夥伴呼叫 CreateProductLinkInvitation 時的必填欄位 行為改變 為廣告合作夥伴建立產品連結邀請時，請務必提供 allowed_domain。
規劃
GenerateCreatorInsightsRequest 中的 search_brand 欄位 無 移除 請改用 search_topics。
Targeting 中的 plannable_location_id 欄位和 GenerateReachForecastRequest 中的 cookie_frequency_cap 欄位 無 移除 改用 plannable_location_ids 和 cookie_frequency_cap_setting。
報表
GenerateBenchmarksMetricsResponse 和 BreakdownMetrics 中的 customer_metrics 欄位，類型為 Metrics CustomerMetrics 類型的欄位 類型變更 / 行為改變 請更新整合功能，改用新的 CustomerMetrics 類型，其中只包含代表客戶廣告成效的指標。

功能與更新 (非重大變更)

功能與更新 類型 說明
廣告
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS 新的列舉值 / 行為 DemandGenMultiAssetAds可使用。啟用後，系統會以非動畫圖片做為輸入內容，生成動畫圖片。從這個 API 版本開始，新的 DemandGenMultiAssetAds 預設為啟用。
合成內容資訊可變動性 行為變更 Asset.synthetic_content_info 和 Ad.synthetic_content_info 在第 25、24 和 23 版中完全可變動。
廣告活動
忠誠度留存目標 新功能 / 設定 新增對會員留存率目標的支援，廣告主可將廣告活動調整至最佳狀態，留住會員方案成員。
新獲客目標介面 新功能 / 設定 更新 Google Ads API 中的獲客目標支援，以反映經過修訂的統一目標結構：
轉換
YouTube 第三方轉換歸因 新欄位 新增支援使用第三方合作夥伴驗證 YouTube 轉換歸因： 詳情請參閱說明中心文章。
一般
ContactDetails.phone_number_extension 新欄位 已新增至 LocalServicesLead 資源。
IncentiveError 新的列舉值和錯誤 新增獎勵兌換失敗的特定錯誤代碼：
規劃
熱門趨勢洞察中的 YouTube 頻道詳細資料 新欄位 搜尋熱門趨勢洞察時，支援更多相關影片的 YouTube 頻道詳細資料。在 YouTubeVideoAttributeMetadata 中新增 channel_id、channel_name 和 channel_url 欄位。
YouTubeChannelInsights.data_sharing_consent_given 新欄位 已新增至YouTubeChannelInsights。前提是創作者已同意分享非公開資料。如果是，系統會填入下列欄位：
報表
ad_sub_format_type 新增區隔 提供 YouTube 串流內不可略過廣告的時長細目： 這個區隔必須一律與 ad_format_type 一併選取。可使用 AdGroup、AdGroupAd、Campaign、Customer、Video 和 VideoEnhancement 選取。
影片專屬社群指標 新欄位 / 指標 新增影片專屬社群指標，協助廣告主追蹤 YouTube Shorts 廣告的使用者參與度 (留言、喜歡和分享次數)： 這些功能適用於 AdGroup、AdGroupAd、Asset、Campaign、Customer 和 Video。

v24 主要和子版本

Google Ads API 24 版包含下列新功能、更新和破壞性變更。

v24.2 (2026-06-24)

Google Ads API v24.2 新增下列功能和更新。子版本 (例如 v24.2) 不含破壞性變更。

功能與更新 類型 說明
廣告
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT 新的列舉值 從到達網頁生成文字資訊，顯示在 DemandGenVideoResponsiveAd 執行個體的參與度面板中 (從這個 API 版本開始，系統預設會啟用這項功能)。
素材資源
AssetGroup.google_local_services_info 新欄位 在最高成效廣告活動中新增支援在地生活服務廣告資訊 (類別 ID 和附註)。
AssetGroupSignal.local_services_id 新欄位 新增這項功能，是為了在最高成效廣告活動中，支援在地生活服務廣告服務 ID 信號。
AssetGroupSignal.vertical_ads_item_group_rule_list 新欄位 新增支援直向廣告項目群組規則，可在最高成效廣告活動中從附加的直向動態饋給選取項目。這項功能僅適用於許可清單中的帳戶。
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN 新的列舉值 / 錯誤 嘗試從廣告活動中移除所有素材資源群組時，系統會傳回這個錯誤。
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS 新的列舉值 / 錯誤 嘗試從素材資源群組中移除所有信號時傳回。
廣告活動
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings
Campaign.PmaxCampaignSettings.local_services_enabled		 新欄位 支援辨識在地生活服務最高成效廣告活動。
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps 新欄位 需求開發廣告群組的可選管道包含 Google 地圖。
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN 新的列舉值 / 錯誤 嘗試從在地生活服務最高成效廣告活動中移除所有地區時，系統會傳回這個錯誤。
SmartCampaignErrorEnum.CREATION_FAILED 新的列舉值 / 錯誤 嘗試建立新的智慧廣告活動時傳回。
轉換
ConversionOrigin.LOCAL_SERVICES_ADS
ConversionActionType.LOCAL_SERVICES_ADS		 新的列舉值 代表使用者點按在地生活服務廣告，並致電、傳送訊息或預訂廣告主服務時發生的轉換。
實驗
COMPARE_CAMPAIGNS
PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION		 新的列舉值 新增對新 ExperimentType 類型的支援：
  • COMPARE_CAMPAIGNS：用於廣告活動組合實驗和自訂最高成效廣告活動實驗，在單一實驗中比較相同或不同類型的多個廣告活動。
  • PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION：用於最高成效廣告活動最佳化實驗，測試文字自訂和最終到達網址擴展功能。
一般
Asset.synthetic_content_info
Ad.synthetic_content_info		 新欄位 包含合成/AI 生成內容的聲明，分為 advertiser_attestation (由廣告主直接提供的聲明) 和 system_attestation (由系統自動偵測或提供的聲明)。

這項功能已向後移植至 v23 和 v22。

為協助您規劃 v25 的整合工作，我們將提早在 v22 以上版本推出用於變更廣告主認證欄位的介面。這些版本會顯示介面，但 synthetic_content_info.advertiser_attestation.status 和 synthetic_content_info.advertiser_attestation.source 在這些版本中仍維持不變。

如果您嘗試對其中任一欄位提出變更要求，系統會傳回下列其中一項錯誤：

「嘗試變更的欄位不可變更」或「無法設定欄位」。

從第 25 版開始，這些欄位將完全可變更。建議您立即使用介面建構及測試內部邏輯，以便在 v25 推出時，系統已準備好使用完整寫入功能。
多方授權 新功能 新增支援多方授權 (MPA) 審查：
這項功能已向後移植至 v23.3、v22.2 和 v21.2。
IncentiveService.FetchIncentive 行為改變 如果要求中提供的電子郵件地址無效，這個方法現在會順利改為傳回預設獎勵優惠，而不是擲回 AuthenticationError.INVALID_EMAIL_ADDRESS 錯誤。
規劃
GenerateCreatorInsightsRequest.search_topics 新欄位 已新增至 ContentCreatorInsightsService.GenerateCreatorInsights 服務。這個選項會搜尋在 country_locations 指定國家/地區中，討論某個主題的創作者 (僅支援搜尋一個國家/地區)。
CREATOR_TOPIC_INSIGHTS 新列舉值 新增至 InsightsKnowledgeGraphEntityCapabilities，表示用於搜尋討論某主題的創作者的實體。這些實體應在 search_topics 欄位中使用。使用 AudienceInsightsService.ListAudienceInsightsAttributes 擷取。
KnowledgeGraphEntitySearchOptions 新類型 / 選項 包含 ListAudienceInsightsAttributes 的其他主題搜尋選項，包括擷取所有支援做為創作者屬性的主題，以及依功能篩選。
GenerateCreatorInsightsRequest.supplemental_data
GenerateTrendingInsightsRequest.supplemental_data		 新欄位 ContentCreatorInsightsService 方法的選用輸入內容。提供這個欄位後，回應中會填入其他位置或創作者屬性。
local_creator_insights
related_local_creators		 新欄位 當 supplemental_data 包含 LOCAL_CREATOR_DATA 列舉時，系統會填入這個欄位。顯示同意分享位置資料，且位於或來自所選國家/地區的創作者。
GenerateTrendingInsightsRequest.sub_country_locations 新欄位 已新增至 ContentCreatorInsightsService.GenerateTrendingInsights，可依國家/地區和子國家/地區搜尋熱門洞察資料。
報表
PerformanceMaxPlacementView 區隔擴充功能 由 ad_network_type 啟用區隔功能。
Google 購物
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads 新欄位 如果設為 true，系統會忽略購物廣告的品牌排除條件。僅支援購物廣告活動。
指定目標
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE 新的列舉值 / 錯誤 嘗試指定不允許的語言時，系統會傳回這個錯誤。
影片
DataLink.youtube_link_metadata 新欄位 包含 brand_channel_id，用於指定連結的 YouTube 品牌頻道 ID。

v24.1 (2026-05-13)

Google Ads API 24.1 版新增了下列功能和更新。子版本 (例如 v24.1) 不含破壞性變更。

功能與更新 類型 說明
廣告
DemandGenMultiAssetAdInfo.classic_display_images 新欄位 放送自訂上傳的多媒體廣告圖片，不必提供額外的回應式素材資源。
實驗
ADOPT_AI_MAX
ADOPT_BROAD_MATCH_KEYWORDS
OPTIMIZE_ASSETS
PMAX_REPLACEMENT_SHOPPING		 新的列舉值 新增對新 ExperimentType 類型的支援：
  • ADOPT_AI_MAX：這類實驗會測試 AI Max 如何運用 Google AI 和廣泛比對關鍵字為您吸引更多顧客。
  • ADOPT_BROAD_MATCH_KEYWORDS：用於測試廣泛比對關鍵字對廣告顯示搜尋次數的影響。
  • OPTIMIZE_ASSETS：用於最佳化素材資源的自訂實驗。
  • PMAX_REPLACEMENT_SHOPPING：用於測試購物廣告活動與最高成效廣告活動的成效差異。
Experiment.video_experiment 新欄位 支援由影片廣告活動組成的現有YOUTUBE_CUSTOM實驗設定。
ExperimentArm.asset_testing_info
ExperimentArm.asset_groups
ExperimentArm.performance_max_experiment_arm_info		 新欄位 公開欄位，支援實驗組中的素材資源測試、素材資源群組和最高成效設定：
  • asset_testing_info：：與實驗廣告副本相關聯的素材資源詳細資料。
  • asset_groups：最佳化素材資源實驗的實驗組素材資源群組清單。
  • performance_max_experiment_arm_info：PMAX_REPLACEMENT_SHOPPING實驗中最高成效廣告活動的設定。
一般
CustomerUserAccess.passkey_enabled 新欄位 唯讀欄位，指出使用者是否已啟用密碼金鑰。
報表
mobile_device_platform 新增區隔 可依使用者裝置的平台 (例如 iOS 或 Android) 區隔報表。
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED 新的列舉值 / 錯誤 如果查詢日期範圍不支援所要求的每日、每小時或每週時間精細程度 (僅適用於過去 37 個月)，系統就會傳回這項錯誤。
vertical_ads_listing_user_rating
vertical_ads_listing_venue		 新區隔 用於直向廣告的新區隔。
user_rating、venue、event_participant_display_name 新篩選條件 支援在 VerticalAdsItemGroupRuleInfo 中篩選 SharedCriterion 資源。
控制組/實驗組實驗指標 新欄位 新增了七個核心指標系列 (點擊、曝光、費用、轉換、單次轉換費用、轉換價值、轉換價值/費用) 的控制組值 (control_clicks 等)、實驗組值 (clicks 等)、點估計值 (clicks_point_estimate 等)、誤差範圍 (clicks_margin_of_error 等) 和 p 值 (clicks_p_value 等)。
轉換絕對變化指標 新欄位 支援使用點估計值、誤差範圍和 p 值欄位，估算Conversions 絕對差異。
指定目標
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS 新的列舉值 / 錯誤 嘗試排除所有客層目標時傳回。
影片
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR 新的列舉值 發布 ZEFR 做為第三方可視度整合服務合作夥伴。
DataLink.youtube_video.channel_id 新欄位 公開與資料連結相關聯的 YouTube 頻道 ID。

v24 (2026-04-22)

Google Ads API v24 是主要版本，新增了下列功能、更新和重大變更。

如需相關指引，請參閱「升級至最新版本」。

破壞性變更

初始狀態 新狀態 變更類型 實作指南
廣告
DemandGenVideoResponsiveAdInfo 中的選填 videos 和 logo_images 必填欄位 行為改變 建立或變更回應式需求開發影片廣告時，請提供 videos 和 logo_images。
VideoResponsiveAdInfo 中的選用 videos、business_name 和 logo_images 必填欄位 行為改變 建立或變更影片回應式廣告時，請提供 videos、business_name 和 logo_images。請注意，VideoResponsiveAdInfo 現在可以變動。
廣告活動
Campaign.video_brand_safety_suitability 無 移除 廣告活動層級合適度控制項已移除。客戶層級仍可使用品牌安全合適度。請改用 Customer.video_brand_safety_suitability。
轉換
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS 無 移除 「會員註冊」使用者類別已移除。移除對該項目的程式碼參照。
規劃
topic_audience_combinations 的 InsightsAudienceAttributeGroup 類型 「common.InsightsAudienceAttributeGroup」類型 行為改變 / 類型變更 必須更新類型用戶端程式庫整合，才能使用新的資源命名空間。
ReachPlanService.ListPlannableProducts 中的 youtube_select_lineups 欄位 無 移除 改用youtube_select_lineup_targeting的首選頻道。
ContentCreatorInsightsService.GenerateCreatorInsights 和 GenerateTrendingInsights 中的 is_brand_connect_creator 欄位 無 移除 請改為查看創作者是否在 partnership_opportunities 中提供 CREATOR_PARTNERSHIPS。
KeywordPlanIdeaService.GenerateKeywordForecastMetrics中的 geo_modifiers 和 biddable_keywords geo_target_constants和keywords 重新命名 / 移除 由 CampaignToForecast.geo_target_constants[] 和 ForecastAdGroup.keywords[] 取代。
GenerateKeywordForecastMetrics 中已淘汰的關鍵字企劃書 / 預測欄位 無 移除 移除下列企劃書 / 預測欄位和類型： 請視需要更新整合項目。
報表
campaign_budget中的 ad_sub_network_type 區隔 無 移除 已移除 campaign_budget 資源的「ad_sub_network_type」區隔。
素材資源檢視畫面中的click_type區隔 無 移除 已從「AdGroupAsset」、「CampaignAsset」和「CustomerAsset」檢視畫面中移除區隔。
影片
ShareablePreviewService.GenerateShareablePreviews 允許部分失敗 沒有部分失敗 行為改變 如果要求中的任何 ID 未通過驗證，要求就會失敗並擲回錯誤。
ShareablePreviewError 舊版代碼： MutateErrorEnum.RESOURCE_NOT_FOUND
ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST		 重新命名 / 行為改變 素材資源群組傳回的錯誤代碼已修改，與廣告群組廣告錯誤一致。更新驗證 catch 邏輯。

功能和更新 (非破壞性)

功能與更新 類型 說明
廣告
VideoResponsiveAdInfo 的可變動性 行為改變 回應式影片廣告資訊物件現可變動。
素材資源
travel_feed_data 位於 AssetSet 新欄位 新增功能，可擷取旅遊動態饋給素材資源屬性 (hotel_center_account_id、merchant_center_id、partner_center_id、subset_id、travel_feed_vertical_type)。
廣告活動
Campaign.view_through_conversion_optimization_enabled 新欄位 允許在需求開發和應用程式廣告活動中啟用瀏覽後轉換最佳化功能 (預設為 false)。
CampaignCriterion.gender 新功能 在所有 Google Ads API 版本中，為最高成效廣告活動啟用性別排除條件。
轉換
待開發客戶產生轉換類型 新的列舉值 在 ConversionActionType 中新增 GA4/Firebase 轉換動作類型列舉：
  • GOOGLE_ANALYTICS_4_GENERATE_LEAD
  • GOOGLE_ANALYTICS_4_QUALIFY_LEAD
  • GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD
  • FIREBASE_ANDROID_GENERATE_LEAD
  • FIREBASE_ANDROID_QUALIFY_LEAD
  • FIREBASE_ANDROID_CLOSE_CONVERT_LEAD
  • FIREBASE_IOS_GENERATE_LEAD
  • FIREBASE_IOS_QUALIFY_LEAD
  • FIREBASE_IOS_CLOSE_CONVERT_LEAD
一般
UserListErrorEnum.DUPLICATE_LOOKALIKE 新的列舉值 / 錯誤 嘗試建立多個相同的類似清單時，系統會傳回這則訊息。
規劃
ListPlannableProductsResponse 中的 ProductCoreAttributes 個欄位 新欄位 在 ListPlannableProductsResponse 下方的 ProductCoreAttributes 中，新增可規劃產品說明、行銷目標、費用模式和購買方式。
報表
CartDataSalesView 新的報表資源 除了點擊的產品外，還會顯示按銷售的特定產品 (品牌等) 細分的轉換指標報表。
不可出價的指標 新欄位 在所有相符資源中新增不可出價的指標 (顯示廣告活動未設為最佳化目標的轉換)：
conversion_attribution_event_type 新增區隔 已新增至ShoppingPerformanceView。
Google 購物
ShoppingProduct 中的應用程式廣告活動 新功能 ShoppingProduct 資源中支援的應用程式廣告活動。不支援附註狀態和問題。
根據標記篩選產品 新功能 推出動態使用邏輯集合運算式篩選的功能： 這項功能僅適用於許可清單中的帳戶。

v23 主要和子版本

Google Ads API 23 版包含下列新功能、更新和破壞性變更。

v23.3 (2026-06-24)

Google Ads API 23.3 版新增下列功能和更新。子版本 (例如 v23.3) 不含破壞性變更。

功能與更新 類型 說明
一般
Asset.synthetic_content_info
Ad.synthetic_content_info		 新欄位 包含合成/AI 生成內容的認證，分為 advertiser_attestation (廣告主直接提供的聲明) 和 system_attestation (Google 系統自動偵測或提供的認證)。

為協助您規劃即將推出的第 25 版整合作業，我們提前在第 22 版以上版本中，推出可變動廣告主認證欄位的介面。這些版本會顯示介面，但 synthetic_content_info.advertiser_attestation.status 和 synthetic_content_info.advertiser_attestation.source 在這些版本中仍維持不變。

如果您嘗試對其中任一欄位提出變更要求，系統會傳回下列其中一項錯誤：

「嘗試變更的欄位不可變更」或「無法設定欄位」。

從第 25 版開始，這些欄位將完全可變更。建議您現在就使用介面建構及測試內部邏輯，確保系統在第 25 版推出時，已準備好支援完整寫入功能。
多方核准 新功能 新增多方核准 (MPA) 審查支援：

v23.2 (2026-03-25)

Google Ads API 23.2 版新增下列功能和更新。v23.2 等次要版本不會包含破壞性變更。

功能與更新 類型 說明
素材資源
VideoEnhancement 新資源 包含強化功能專屬的影片廣告資訊，例如是否為 Google 生成或廣告主提供的影片。詳情請參閱「影片強化功能簡介」。
AppTopCombinationView 新資源 唯讀資源，可提供應用程式廣告活動中成效最佳素材資源組合的洞察資料。
CustomerAsset 新功能 新增支援功能，可擷取 field_type 設為 BUSINESS_LOGO 的 CustomerAsset。
廣告活動
AdGroupAd.start_date_time
AdGroupAd.end_date_time		 新欄位 針對廣告活動日期提供更精細的排程限制。這項功能僅支援部分廣告群組類型。
HotelSettingInfo.disable_hotel_setting 新欄位 允許在需求開發廣告活動中停用飯店動態饋給。
一般
CustomerClientLinkError 新的列舉值 / 錯誤 新增兩個錯誤代碼：MAX_CUSTOMER_LIMIT_REACHED 和 ACCOUNT_CREATION_POLICY_VIOLATION。
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS 行為改變 嘗試使用這類已淘汰的顧客名單顧客類型類別時，系統會擲回錯誤。
規劃
GenerateTrendingInsights
GenerateCreatorInsights		 新功能 新增支援自訂實體、主題和目標對象的 AND/OR 組合。
ReachPlanService.GenerateReachForecast 新的列舉值 新增可指定的年齡層，例如 AGE_RANGE_21_44 或 AGE_RANGE_21_49。
youtube_select_lineup_targeting 新欄位 已新增至 ReachPlanService.ListPlannableProducts，將取代 youtube_select_lineups。目前這兩個欄位都會填入資料。
ReachPlanSurface 新列舉值 新增 IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS 做為平台選項。
Forecast 新欄位 在ReachPlanService.GenerateReachForecast中，為需求開發廣告活動新增「盡量爭取點擊」最高單次點擊出價clicks。
partnership_opportunities 新欄位 已新增至 ContentCreatorInsightsService.GenerateCreatorInsights 和 ContentCreatorInsightsService.GenerateTrendingInsights。
報表
biddable_indirect_install_first_in_app_conversion_micros 新欄位 已新增至 Campaign、Customer 和 AdGroup 資源。
影片
ShareablePreviewService 新功能 已擴充支援 YouTube 直播預覽，方法是將 preview_type 設為 YOUTUBE_LIVE_PREVIEW。將 UNSUPPORTED_AD_TYPE 和 TOO_MANY_RESOURCES_IN_REQUEST 新增至 ShareablePreviewError。這項功能僅支援部分廣告類型。

v23.1 (2026-02-25)

Google Ads API 23.1 版新增了下列功能和更新。v23.1 等次要版本不會包含破壞性變更。

功能與更新 類型 說明
帳戶管理
advertising_partner_properties.allowed_domain 新欄位 已新增至 ProductLinkInvitation 和 ProductLink 資源。廣告合作夥伴只能在這個網域放送廣告。
Customer.contains_eu_political_advertising 新欄位 擷取帳戶層級的聲明狀態，判斷是否含有以歐盟為目標的政治廣告，並傳回 EuPoliticalAdvertisingStatus。
廣告活動
Campaign.text_guidelines 新欄位 新增文字規範支援，可與最高成效和搜尋廣告活動搭配使用，以程式輔助方式控管 AI 生成的文字素材資源。在 text_guidelines 中，您可以定義 term_exclusions 和 messaging_restrictions。
CampaignPrimaryStatusReason 新的列舉值 新增 CAMPAIGN_NOT_BOOKED、BOOKING_HOLD_EXPIRING、BOOKING_HOLD_EXPIRED 和 BOOKING_CANCELLED，為採用 FIXED_CPM 出價策略的廣告活動提供主要狀態原因。
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure
Campaign.VideoCampaignSettings.booking_details		 新欄位 新增預訂廣告類別自行揭露和唯讀預訂詳細資料的支援。
Campaign.missing_eu_political_advertising_declaration 新欄位 支援查詢及篩選缺少聲明的廣告活動，這些聲明與廣告活動是否含有以歐盟為目標的政治廣告有關。
轉換
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS 新的列舉值 支援追蹤使用者觀看廣告後，又觀看同一頻道影片的行為。
一般
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED 新的列舉值 / 錯誤 嘗試只指定客層維度中的未確定類別時，系統會傳回這個錯誤。
獎勵
IncentiveErrorEnum 新的列舉值 / 錯誤 新增兩個錯誤代碼：MAX_INCENTIVES_REDEEMED 和 ACCOUNT_TOO_OLD。2026 年 3 月 11 日當天或之後提出的要求，可能會傳回這些錯誤。
規劃
GenerateBenchmarksMetrics 新功能 新增使用 BreakdownDefinition 依日期細分的支援。
ReachPlanService.GenerateReachForecast 新列舉值 需求開發廣告活動的「盡量爭取轉換」出價策略，現在可指定 GOOGLE_DISPLAY_NETWORK 做為廣告刊登位置。
GenerateTrendingInsights 新欄位 在依主題搜尋時，TrendInsightDataPoint 會顯示歷來趨勢線資訊 TrendInsights。
報表
不重複使用者頻率指標 新欄位 新增指標，可記錄有多少使用者看過廣告至少兩次、三次、四次、五次或十次：unique_users_two_plus、unique_users_three_plus、unique_users_four_plus、unique_users_five_plus 和 unique_users_ten_plus。
SearchTermMatchSource 新的列舉值 新增 VERTICAL_ADS_DATA_FEED，支援垂直廣告資料動態饋給，例如旅遊廣告實體指定目標。
YouTubeVideoUpload
YouTubeVideoUpload 新服務 / 資源 新增 YouTubeVideoUpload 服務，支援在 YouTube 上傳及管理影片，並新增 YouTubeVideoUpload 資源，支援擷取上傳狀態和中繼資料。這項功能僅適用於 REST 和 Python 用戶端程式庫。

v23 (2026-01-28)

Google Ads API v23 是主要版本，新增了下列功能、更新和破壞性變更。

如需操作說明，請參閱「升級至最新版本」。

破壞性變更

初始狀態 新狀態 變更類型 實作指南
廣告
允許廣告分享 AdGroupAdError.AD_SHARING_NOT_ALLOWED 行為改變 系統不再允許在多個廣告群組之間共用廣告。嘗試分享廣告的要求會傳回 AD_SHARING_NOT_ALLOWED 錯誤。
支援 CallAd 和 CallAdInfo 無 移除 系統已不再支援來電廣告。請參閱「關於來電廣告」說明中心文章。
廣告活動
Campaign.start_date
Campaign.end_date		 Campaign.start_date_time
Campaign.end_date_time		 重新命名 / 替換 使用新的日期時間欄位，指定廣告活動的時間元件。系統會移除原始的僅限日期欄位。
需求開發
DemandGenMultiAssetAdInfo.lead_form_only 無 移除 已移除「lead_form_only」欄位。更新程式碼中的參照。
報表
匯總素材資源成效標籤指標和列舉 無 移除 移除匯總素材資源成效標籤指標。搜尋和多媒體廣告活動不再傳回成效標籤列舉。

功能和更新 (非破壞性)

功能與更新 類型 說明
廣告
AdFormatType 新的列舉值 新增格式類型：TEXT、VERTICAL_ADS_BOOKING_LINK 和 VERTICAL_ADS_PROMOTION。
素材資源
asset_group 次觀看 新欄位 新增下列指標：metrics.engagements、metrics.engagement_rate 和 metrics.average_cpe。
asset_group_asset 檢視畫面 新欄位 新增下列指標：metrics.average_cpe、metrics.average_cpm、metrics.trueview_average_cpv、metrics.video_trueview_view_rate、metrics.video_trueview_views 和 metrics.interaction_event_types。
Asset.orientation 新欄位 圖片和影片素材資源新增了唯讀的螢幕方向欄位。
CampaignAsset 新功能 新增支援功能，可擷取 field_type 設為 HEADLINE 和 DESCRIPTION 的廣告活動素材資源。
ServedAssetFieldType 新的列舉值 新增 HEADLINE_AS_SITELINK_POSITION_ONE、HEADLINE_AS_SITELINK_POSITION_TWO、DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE 和 DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO，用於做為網站連結放送的素材資源。
BusinessMessageAsset 新功能 / 支援 更新消費者訊息素材資源：
帳單
InvoiceService.ListInvoices 新選項 現在只要在 ListInvoicesRequest 中設定 include_granular_level_invoice_details，即可在 Invoice 中傳回更精細的詳細資料，包括廣告活動層級費用明細、逐項列出的法規費用和調整項資訊。
RegulatoryFeeType
UnitOfMeasure		 新列舉 新增規費和測量單位的輔助列舉。
廣告活動
CampaignError 新的列舉值 / 錯誤 新增 DURATION_TOO_LONG_FOR_TOTAL_BUDGET 和 END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET 錯誤代碼。
轉換
ConversionActionCategory 新的列舉值 新增 YOUTUBE_FOLLOW_ON_VIEWS，用於追蹤觀看廣告後，又觀看同一頻道影片的使用者。
需求開發
DemandGenVideoResponsiveAdInfo.companion_banner 新欄位 需求開發回應式影片廣告現在支援隨播橫幅廣告。
獎勵
新增「自選獎勵」支援：

為方便以程式輔助方式更精細地處理失敗情形，我們會在日後推出的版本中，於 IncentivesService 中新增其他錯誤代碼。建議您留意即將發布的公告和版本資訊，瞭解這些新的錯誤代碼，確保應用程式能處理這些新的失敗模式。
規劃
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST 新列舉值 允許在GenerateAudienceCompositionInsights、GenerateSuggestedTargetingInsights、GenerateInsightsFinderReport和GenerateCreatorInsights中使用人生大事建立目標對象。

其他 AudienceInsightsService 方法 (例如 AudienceInsightsService.GenerateAudienceOverlap 和 AudienceInsightsService.GenerateTargetingSuggestionMetrics) 不支援人生大事。
ReachPlanService.GenerateConversionRates 新欄位 / 選項 現在，系統會根據介面控制項 (例如 Gmail、Shorts) 提供轉換率建議，並將這些介面納入回覆。僅支援需求開發廣告活動。
LanguageDistribution 新欄位 / 類型 YouTubeChannelInsights：新增這項指標，提供 YouTube 頻道內容的語言分布詳細資料。
BenchmarksService 新服務 比較 YouTube 廣告資料與業界基準。
AudienceInsightsService.GenerateAudienceDefinition 新方法 使用生成式 AI，將目標對象的自由文字說明，翻譯成相符的目標對象屬性。
YouTubeChannelInsights.relevance_score 新欄位 評估創作者與主題的關聯性，並根據觀看次數加權。
TrendInsightMetrics.trend_change_percent 新欄位 代表趨勢值在比較期間內的百分比變化。
建議
GenerateRecommendationsRequest 新欄位 新增了 is_new_customer。如果將 CAMPAIGN_BUDGET 最佳化建議設為 true，系統會使用針對新顧客最佳化的模式 (僅建議沒有廣告活動的客戶使用)。
報表
AdGroupAdAssetView 支援新功能 / 指標 現在支援 RESPONSIVE_DISPLAY_AD 的曝光、成效和轉換指標。
ad_sub_network_type 區隔 新增區隔 提供廣告聯播網內的詳細成效細目。這項功能一開始僅適用於 YouTube 需求開發廣告活動 (串流內、動態內廣告、Shorts)，必須與 ad_network_type 一併選取。
最高成效廣告活動報表 新功能 啟用最高成效廣告活動的廣告聯播網類型細目。
UserLocationView
GeographicView		 支援新區隔 支援按轉換日期區隔的指標：conversions_by_conversion_date、all_conversions_by_conversion_date、conversions_value_by_conversion_date、all_conversions_value_by_conversion_date、value_per_conversions_by_conversion_date、value_per_all_conversions_by_conversion_date、cross_device_conversions_by_conversion_date 和 cross_device_conversions_value_by_conversion_date。
直向廣告區隔 新區隔 新增下列區隔：vertical_ads_event_participant_display_names、vertical_ads_hotel_class、vertical_ads_listing、vertical_ads_listing_brand、vertical_ads_listing_city、vertical_ads_listing_country、vertical_ads_listing_region、vertical_ads_partner_account 和 vertical_ads_vertical。
PerStoreView
MatchedLocationInterestView		 新報表資源 新增 PerStoreView 查詢商店地點詳細資料，以及 MatchedLocationInterestView (適用於 AI Max 廣告活動)，依興趣點的地理位置提供成效指標。
Google 購物
ShoppingPerformanceView 支援新指標 現在支援下列依轉換日期區隔的指標：conversions_by_conversion_date、all_conversions_by_conversion_date、conversions_value_by_conversion_date、value_per_conversions_by_conversion_date、value_per_all_conversions_by_conversion_date。
ShoppingPerformanceView 支援新指標 新增對 search_budget_lost_impression_share、search_rank_lost_impression_share、search_budget_lost_absolute_top_impression_share 和 search_rank_lost_absolute_top_impression_share 的支援。
ShoppingProduct.product_image_uri 新欄位 已新增至ShoppingProduct。
直向廣告
AdGroup.vertical_ads_format_setting 新欄位 可控管哪些廣告格式能在使用旅遊動態饋給的搜尋廣告活動中放送。
AdGroupCriterion
SharedCriterion		 新欄位 / 條件 在 AdGroupCriterion 和 vertical_ads_item_group_rule 中新增 vertical_ads_item_group_rule_list 條件類型，在 SharedCriterion 中新增，允許在搜尋廣告活動中透過旅遊動態饋給指定目標商品群組。
整合產業特有廣告資料動態饋給 新功能 現在可將產業廣告資料動態饋給連結至放送 AI Max 的搜尋廣告活動，在文字廣告旁顯示房源宣傳和預訂連結旅遊廣告。使用 vertical_ads_format_setting 控制格式，並使用 vertical_ads_item_group_rule 定義規則。依AdFormatType和直向廣告資料動態饋給維度區隔報表。
影片
AdVideoAssetInfo.ad_video_asset_feature_control 新欄位 新增影片廣告素材資源的功能控制選項。
CampaignCriterionError 新的列舉值 / 錯誤 新增 INVALID_VIDEO_LINEUP_ID 錯誤代碼。
YouTube 可聽度指標 新指標 新增 YouTube 音訊廣告的可聽度指標，可回報廣告是否可聽，以及可評估可聽度的曝光次數。

封存的版本資訊

如要查看封存的版本資訊，請參閱「已淘汰版本」。