版本資訊

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

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 欄位 無 移除 請改用 Customer.conversion_tracking_setting 的 ConversionTrackingSetting.enablement_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 轉換動作類型，方便您擷取及修改這些轉換動作。此外，我們也在 ConversionActionCategory 中公開 IN_APP_AD_REVENUE 類別，用於追蹤應用程式內廣告營利收益。
一般
BusinessProfileLocationSyncError 新列舉和錯誤 新增在 LOCATION_SYNC 類型的 AssetSet 中同步處理地點時，商家檔案地點同步處理錯誤的原因。API 現在會傳回 BusinessProfileLocationSyncError 和特定原因 (EMAIL_INVALID、OAUTH_TOKEN_INVALID、ACCOUNT_REMOVED 和 NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT)，而非傳回一般 UNKNOWN 錯誤。
規劃
第 BenchmarksService.GenerateBenchmarksMetrics 個百分位數指標 新功能

更新 BenchmarksService.GenerateBenchmarksMetrics，以百分位數層級格式提供指標，代表顧客在其他廣告主中的競爭地位。指標會傳回至新 CustomerMetrics.percentile_metrics 欄位 (位於 GenerateBenchmarksMetricsResponse.customer_metrics 和 BreakdownMetrics.customer_metrics) 的 PercentileMetrics，並以 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 選取)：
直向廣告區隔 新區隔 在 Segments 中，新增下列飯店和旅遊產業廣告報表區隔 (可透過 campaign、ad_group 和 customer 選取)：

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 新的列舉值 / 錯誤 如果 Google Cloud 雲端專案的存取層級為 TEST，但嘗試對非測試帳戶提出要求，就會傳回這個錯誤。
規劃
品牌觀感洞察 新功能 在 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 新條件類型 在 AdGroupCriterion.criterion 中新增 vertical_ads_item_bid 條件類型。

v25 (2026-07-22)

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

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

破壞性變更

初始狀態 新狀態 變更類型 實作指南
廣告活動
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) 無 移除 使用改版後的統一目標結構定義：
一般
Incentive Service 要求和回應訊息中的巢狀列舉欄位：
  • 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 在 v25、v24 和 v23 中現已完全可變動。
廣告活動
忠誠度留存目標 新功能 / 設定 新增對會員留存率目標的支援，廣告主可將廣告活動調整至最佳狀態，留住會員方案成員。
新獲客目標介面 新功能 / 設定 更新 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 24.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 在這些版本中仍維持不變。

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

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

自 v25 起，這些欄位將完全可變。建議您現在就使用介面建構及測試內部邏輯，確保系統在第 25 版推出時，已準備好支援完整寫入功能。
多方授權 新功能 新增多方授權 (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 無 移除 「會員註冊」使用者類別已移除。移除程式碼中對該 API 的參照。
規劃
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 v23.3 新增了下列功能和更新。子版本 (例如 v23.3) 不含破壞性變更。

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

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

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

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

從第 25 版開始，這些欄位將完全可變更。建議您立即使用介面建構及測試內部邏輯，以便在 v25 推出時，系統已準備好使用完整寫入功能。
多方核准 新功能 新增多方核准 (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。在 ShareablePreviewError 中新增了 UNSUPPORTED_AD_TYPE 和 TOO_MANY_RESOURCES_IN_REQUEST，這項功能僅支援部分廣告類型。

v23.1 (2026-02-25)

Google Ads API v23.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。如果設為 true，系統會使用針對新客最佳化的模型 (僅建議沒有廣告活動的客戶使用)。CAMPAIGN_BUDGET
報表
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_list 條件類型，並在 SharedCriterion 中新增 vertical_ads_item_group_rule，以便在含旅遊動態饋給的搜尋廣告活動中指定商品群組。
整合直向廣告資料動態饋給 新功能 現在可將產業廣告資料動態饋給連結至放送 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 音訊廣告新增可聽度指標，用於回報廣告是否可聽，以及可評估可聽度的曝光次數。

封存的版本資訊

如需封存的版本資訊，請參閱「已停用版本」。