版本資訊

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

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_input (廣告主直接提供的聲明) 和 system_input (系統自動偵測或提供的認證)。

這項功能已回溯移植到 v23 和 v22。

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

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

「The field attempted to be mutated is immutable」(嘗試變更的欄位不可變更) 或「Field cannot be set」(無法設定欄位)。

這些欄位將在第 25 版中完全可變動。建議您現在就使用介面建構及測試內部邏輯，確保系統在第 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 無 移除 會員註冊使用者類別已移除。移除對該項目的程式碼參照。
規劃
InsightsAudienceAttributeGroup 類型 (適用於 topic_audience_combinations) 「common.InsightsAudienceAttributeGroup」類型 行為轉變 / 類型變更 使用型別用戶端程式庫整合的項目必須更新，才能使用新的資源命名空間。
ReachPlanService.ListPlannableProducts 中的「youtube_select_lineups」欄位 無 移除 改用 youtube_select_lineup_targeting 的陣容。
ContentCreatorInsightsService.GenerateCreatorInsights 和 GenerateTrendingInsights 中的 is_brand_connect_creator 欄位 無 移除 請改為檢查創作者的 partnership_opportunities 中是否有 CREATOR_PARTNERSHIPS。
geo_modifiers 和 biddable_keywords (KeywordPlanIdeaService.GenerateKeywordForecastMetrics) geo_target_constants和keywords 重新命名 / 移除 已由 CampaignToForecast.geo_target_constants[] 和 ForecastAdGroup.keywords[] 取代。
GenerateKeywordForecastMetrics 中已淘汰的關鍵字企劃書 / 預測欄位 無 移除 移除了下列企劃書 / 預測欄位和類型： 視情況更新整合功能。
報表
ad_sub_network_type 區隔，位於 campaign_budget 無 移除 已移除 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		 重新命名 / 行為轉變 素材資源群組傳回的錯誤代碼已修改，與廣告群組廣告錯誤一致。更新驗證擷取邏輯。

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

功能與更新 類型 說明
廣告
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 在這些版本中仍維持不變。

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

「The field attempted to be mutated is immutable」(嘗試變更的欄位不可變更) 或「Field cannot be set」(無法設定欄位)。

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

v23.2 (2026-03-25)

Google Ads API v23.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。設為 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中新增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 音訊廣告的音訊可聽度指標，可回報廣告是否以有聲模式播放，以及可評估音訊可聽度的曝光次數。

v22 主要和次要版本

Google Ads API 第 22 版包含下列新功能、更新和重大變更。

v22.2 (2026-06-24)

Google Ads API v22.2 新增了下列功能和更新。次要版本 (例如 v22.2) 不包含破壞性變更。

功能與更新 類型 說明
一般
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 在這些版本中仍維持不變。

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

「The field attempted to be mutated is immutable」(嘗試變更的欄位不可變更) 或「Field cannot be set」(無法設定欄位)。

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

v22.1 (2026-02-25)

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

功能與更新 類型 說明
帳戶管理
Customer.contains_eu_political_advertising 新欄位 擷取帳戶層級的聲明狀態，判斷是否含有以歐盟為目標的政治廣告，並傳回 EuPoliticalAdvertisingStatus。
廣告活動
Campaign.missing_eu_political_advertising_declaration 新欄位 支援查詢及篩選缺少聲明的廣告活動，這些聲明與廣告活動是否含有以歐盟為目標的政治廣告有關。

v22 (2025-10-15)

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

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

破壞性變更

初始狀態 新狀態 變更類型 實作指南
需求開發
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros minimum_budget_amount_micros 重新命名 / 修正拼字 重新命名參照，使用修正後的欄位名稱。
一般
AddBatchJobOperations 沒有作業限制 每項要求最多可執行 10,000 項作業 行為轉變 請確認單一 AddBatchJobOperations 要求包含的作業不超過 10,000 項。
在 ListBatchJobResultsRequest 中，頁面大小上限為 1,000 傳回 INVALID_PAGE_SIZE 錯誤 行為轉變 請確認 ListBatchJobResultsRequest.page_size 設為 1,000 或更少，因為要求較大的頁面大小現在會導致錯誤。
最高成效
資產成效標籤 無 移除 最高成效廣告活動已移除素材資源成效標籤支援和相關的成效標籤列舉。據此更新整合項目。
Campaign.url_expansion_opt_out AssetAutomationSetting 中的 FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION 旗標 移除 / 更換 使用最終到達網址擴展 - 文字素材資源自動化設定。系統已移除廣告活動層級的網址擴展功能停用欄位。
規劃
views trueview_views 移除 / 更換 在 ReachPlanService 中，將 views 的參照替換為新的 trueview_views 欄位。
影片
average_cpv
video_view_rate
video_views
video_view_rate_in_feed
video_view_rate_in_stream
video_view_rate_shorts		 trueview_average_cpv
video_trueview_view_rate
video_trueview_views
video_trueview_view_rate_in_feed
video_trueview_view_rate_in_stream
video_trueview_view_rate_shorts		 重新命名 更新查詢字串和整合項目，改用代表 TrueView 影片觀看次數的新指標名稱。

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

功能與更新 類型 說明
素材資源
AssetFieldType.LANDING_PAGE_PREVIEW 新的列舉值 新增為圖片素材資源欄位類型。
AssetGenerationService 新服務 (Beta 版) 使用生成式 AI 生成文字和圖片素材資源：
  • GenerateText：根據最終到達網址、提示、關鍵字等產生文字。
  • GenerateImages：根據最終到達網址、提示或重新脈絡化產品圖片生成圖片。
  • 錯誤會以 AssetGenerationError 中的代碼傳回。
最初僅開放給少數封閉 Beta 版參與者。
廣告活動
AppCampaignBiddingStrategyGoalType 新的列舉值 為應用程式安裝廣告活動 (ACi) 新增目標，不必指定目標即可進行最佳化：
  • OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA：搭配標準的「盡量爭取轉換」出價策略使用。
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS：搭配標準的「盡量提高轉換價值」出價策略使用。
BiddingStrategyType 新功能 新增支援固定廣告曝光占有率出價策略類型。
Campaign.feed_types 新欄位 顯示附加至廣告活動的動態饋給類型。如果是最高成效廣告活動，這可能表示商家產業別，例如零售業的 MERCHANT_CENTER_FEED。
共用組合指定目標 新功能 允許將排除關鍵字共用組合附加至多管道 (適用於應用程式廣告活動) 和區域廣告活動。
需求開發
目標單次點擊出價 新功能 新增出價策略，盡量爭取點擊，並設定目標單次點擊出價：使用 Campaign.target_cpc 設定廣告活動層級的目標單次點擊出價，並使用 AdGroup.target_cpc_micros 覆寫廣告群組層級的設定。
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES 新的列舉值 如果啟用 DemandGenMultiAssetAdInfo，系統會將設計元素和文字素材資源嵌入圖片素材資源，建立不同長寬比的新圖片素材資源 (預設為啟用)。
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS 新的列舉值 如果為 DemandGenMultiAssetAdInfo 啟用這項功能，系統會使用圖片和文字等其他素材資源生成影片，然後可用於建立新的 DemandGenVideoResponsiveAdInfo 執行個體 (預設為啟用)。
一般
ListBatchJobResultsRequest 頁面大小備援 行為改變 如果 page_size 未設定或為 0，現在預設為最多 1,000 個 (先前會傳回 INVALID_PAGE_SIZE)。
QuotaError 新的列舉值 / 錯誤 新增 PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED，表示何時超過付款資料啟用率上限。
最高成效
素材資源自動化設定 新的列舉值 新增最高成效廣告活動素材資源自動建立選項：
  • GENERATE_IMAGE_ENHANCEMENT：啟用自動建立強化圖片 (自動裁剪)。(預設為啟用)。
  • GENERATE_IMAGE_EXTRACTION：從最終到達網址取得圖片。預設為帳戶動態圖片額外資訊設定。
最高成效廣告活動報表區隔 新區隔 新增最高成效廣告活動專屬的新區隔：
規劃
顧客關係管理合作夥伴資料名單 新功能 / 列舉值 已將 THIRD_PARTY_PARTNER_DATA 新增至顧客關係管理資料來源，以及合作夥伴目標對象驗證錯誤代碼 (例如接受服務條款、缺少連結等)。
直播創作者指標 新欄位 新增 YouTubeMetrics.is_active_live_stream_creator，由創作者洞察資料傳回，指出創作者是否在過去 90 天內發布過直播。
可規劃的客戶關係管理來源中繼資料 新訊息 在 PlannableUserList 內新增 PlannableUserListMetadata，由 ReachPlanService.ListPlannableUserLists 傳回，顯示顧客關係管理資料來源類型。
TrendInsight 支援相關影片和創作者 新欄位 在 TrendInsight 上新增 related_videos 和 related_creators 的支援，並在 video_properties 和 publish_date 中監看屬性。
改善 InsightsFinder 新功能 GenerateInsightsFinderReport 現在支援 parental_status、income_ranges，以及更複雜的 AND/OR 指定目標組合。
報表
新的點擊類型 新的列舉值 已新增 CLICK_TO_MESSAGE_THIRD_PARTY_CLICK 和 CLICK_TO_MESSAGE_LANDING_PAGE_CLICK。
素材資源群組素材資源區隔 支援新區隔 AssetGroupAsset 現在可依device、conversion_action、conversion_action_name 和conversion_action_category 區隔。
AdGroupAdAssetView 中的回應式搜尋廣告 支援新功能 / 指標 AdGroupAdAssetView 現在完全支援 RESPONSIVE_SEARCH_AD 的成效和轉換指標 (先前只會傳回曝光次數)。
探索查詢叢集指標區隔 支援新區隔 指標 clicks_unique_query_clusters、conversions_unique_query_clusters 和 impressions_unique_query_clusters 現在可依日期欄位區隔。
TargetingExpansionView 新的報表資源 針對手動指定目標的擴展功能 (例如 AI Max 搜尋廣告活動的無關鍵字擴展功能)，在報表指標中新增 TargetingExpansionView。
Google 購物
修正購物範圍 修正錯誤 修正 ShoppingProduct 資源中指標的廣告活動和廣告群組範圍。
統一目標
留存率目標 新功能 新增支援顧客留存率目標，可盡量爭取回訪顧客 (例如使用 target_option 搭配 TARGET_SPECIFIC 或 TARGET_ALL)。
影片
影片觀看時間指標 新欄位 新增觀看時間長度指標：video_watch_time_duration_millis (總長度) 和 average_video_watch_time_duration_millis (每次曝光的平均長度)。

v21 主要和次要版本

Google Ads API 第 21 版包含下列新功能、更新和重大變更。

v21.2 (2026-06-24)

Google Ads API v21.2 新增了下列功能和更新。次要版本 (例如 v21.2) 不包含破壞性變更。

功能與更新 類型 說明
一般
多方核准 新功能 新增支援多方核准 (MPA) 審查：

v21.1 (2026-02-25)

Google Ads API 21.1 版新增了下列功能和更新。次要版本 (例如 v21.1) 不包含破壞性變更。

功能與更新 類型 說明
帳戶管理
Customer.contains_eu_political_advertising 新欄位 擷取帳戶層級的聲明狀態，判斷是否含有以歐盟為目標的政治廣告，並傳回 EuPoliticalAdvertisingStatusEnum。
廣告活動
Campaign.missing_eu_political_advertising_declaration 新欄位 支援查詢及篩選缺少聲明的廣告活動，這些聲明與廣告活動是否含有以歐盟為目標的政治廣告有關。

v21 (2025-08-06)

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

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

破壞性變更

初始狀態 新狀態 變更類型 實作指南
廣告活動
傳回 CriterionError.INVALID_LISTING_GROUP_HIERARCHY 傳回 CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION 錯誤代碼變更 如果要求啟用部分失敗，請處理新的錯誤代碼，而非原始階層錯誤代碼。
轉換
在 ConversionUploadService 中存取 debug_enabled 模式 無 移除 系統會移除「debug_enabled」欄位，更新參照該參數的程式碼，不要設定或查詢這個參數。
歐盟政治廣告異動
歐盟政治廣告的選填廣告活動自我聲明 新廣告活動的必填contains_eu_political_advertising欄位 驗證規則 / 行為轉移 如果未設定這個欄位，API 呼叫將無法建立新廣告活動，並會傳回 FieldError.REQUIRED 錯誤。自 2025 年 9 月 22 日起，聲明為 CONTAINS_EU_POLITICAL_ADVERTISING 的廣告活動將無法在歐盟放送。
無須自主聲明即可修改的條件 無法更新 CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION 驗證規則 / 行為轉移 為現有廣告活動建立或更新廣告活動/廣告群組層級的鄰近地區、地區或地區群組指定條件前，請先設定自我聲明狀態。
沒有自主聲明規定的實驗 無法更新 ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION 驗證規則 / 行為轉移 確認實驗廣告活動已完成自我聲明。
最高成效
brand_guidelines_enabled 預設為 false 預設值為 true 行為轉變 對於新的最高成效廣告活動，系統預設會啟用品牌宣傳指南。如要停用，請將該欄位明確設為 false。
規劃
AudienceInsightsService.GenerateTargetingSuggestionMetrics 的原始輸入引數類型 輸入類型 InsightsAudience 類型變更 更新實作項目，傳遞支援使用者興趣 AND-of-ORs 組合的新輸入類型，允許自訂目標對象定義的潛在觸及指標。

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

功能與更新 類型 說明
AI Max 搜尋廣告活動
Campaign 中的 ai_max_setting.enable_ai_max 新欄位 啟用 AI Max 後，系統會擴大搜尋字詞比對範圍 (在關閉前，系統會沿用先前的文字素材資源自動化和品牌名單)。Campaign.ai_max_setting.bundling_required 欄位會指出是否必須啟用 AI Max 才能遵守/修改這些設定，而 AdGroup.ai_max_ad_group_setting.disable_search_term_matching 則可在廣告群組層級停用比對功能。請參閱「運用 AI Max 搜尋廣告活動，締造更出色的成效」。
CampaignError.AI_MAX_MUST_BE_ENABLED 新的列舉值 / 錯誤 在搜尋廣告活動中選擇啟用網址擴展文字素材資源自動化功能，但未啟用 AI Max 時，系統會擲回這個例外狀況。
廣告群組層級指定目標 新功能 AI Max 搜尋廣告活動新增支援廣告群組層級的品牌清單、地點和網頁 (網址規則)。
ai_max_search_term_ad_combination_view 新的報表資源 報表會顯示搜尋字詞、廣告標題和到達網頁組合的成效。
search_term_match_type 區隔 新的列舉值 新增 AI_MAX 做為搜尋字詞比對類型選項。
素材資源
PromotionAsset 新欄位 新增 terms_and_conditions_text、terms_and_conditions_uri 和 oneof promotion_trigger 選項 (promotion_barcode_info、promotion_qr_code_info)。請參閱「宣傳素材資源簡介」。
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION 新的列舉值 已新增至 AssetAutomationType，可控管搜尋廣告活動中，從最終到達網址自動產生的文字和到達網頁。
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset 新服務 / 方法 允許從廣告活動中移除自動建立的最終到達網址擴展素材資源。
ServedAssetFieldType.DESCRIPTION_PREFIX 新的列舉值 新增內容，修正 ad_group_ad_asset_combination_view 中傳回的類型為 UNKNOWN 的報表問題。
廣告活動
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING 新的列舉值 當受地區限制的廣告活動缺少指定地區時，系統會傳回這項錯誤 (如果指定地區超出允許範圍，系統現在會擲回 LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN)。
整合第三方應用程式數據分析 新欄位 新增 VideoCustomer.third_party_integration_partners 和 Campaign.third_party_integration_partners 的支援。請參閱「使用第三方應用程式數據分析追蹤應用程式轉換」。
Campaign.advertising_partner_ids 新現場支援 現在可以為現有廣告活動設定這個欄位 (設定後即無法變更)。
管理員層級排除刊登位置 新功能 使用 CustomerNegativeCriterion，即可在個別廣告主帳戶中排除刊登位置清單。
目標廣告投資報酬率策略中的容許區間設定 新欄位 在 MaximizeConversionValue 和 TargetRoas 中，新增了對 TargetRoas.target_roas_tolerance_percent_millis 的支援 (適用於搜尋廣告活動組合策略)。
LocationInterestView 新的報表資源 彙整廣告群組指定地區條件的成效。
轉換
conversion_attribution_event_type 區隔 新的列舉值 在轉換歸因類型選項中新增 ENGAGED_VIEW。
需求開發
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM 新的列舉值 / 錯誤 為強制執行需求開發廣告活動的最低每日預算而新增。詳細資料會透過 budgetDailyMinimumErrorDetails 公開。
最高成效
campaign_search_term_view 新的報表資源 在廣告活動層級匯總搜尋字詞指標，以便分析及製作最高成效廣告的搜尋字詞報表。
規劃
ReachPlanService.ListPlannableUserInterests 新方法 可供探索 generateReachForecast 的可規劃興趣相似目標對象和潛在買家興趣。
AdditionalApplicationInfo 新欄位 已在 ReachPlanService.ListPlannableUserLists 中新增為選填輸入內容。
AudienceInsights 屬性清單 新功能 AudienceInsightsService.ListAudienceInsightsAttributes 現在會擷取可用的第一方使用者名單。
AudienceCompositionInsights 指定目標 CRM 名單 新功能 AudienceInsightsService.GenerateAudienceCompositionInsights 現在會傳回 AudienceInsightsDimension 維度的使用者名單索引詳細資料：AGE_RANGE、GENDER、AFFINITY_USER_INTEREST 和 IN_MARKET_USER_INTEREST。
TrendInsightMetrics 目標對象比重 新欄位 代表趨勢的目標對象比例。
KnowledgeGraphAttributeMetadata 類別 新欄位 依相符類別篩選知識圖譜屬性。
報表
資產檢視指標 新功能 / 指標 在 AssetGroupAsset、ChannelAggregateAssetView 和 CampaignAggregateAssetView 中新增多項指標。最高成效廣告活動現在也會回報 impressions 的實際值。
選取器擴充功能 新功能 在 ChangeStatus 中，AssetSet 和 CampaignAssetSet 現在可一併查詢。
search_term_targeting_status 新增區隔 廣告活動搜尋字詞檢視畫面中可選取的區隔。
final_url_expansion_asset_view 新的報表資源 報表會顯示最終到達網址擴展素材資源的成效詳細資料。
素材資源群組價值調整項 新欄位 在 AssetGroup 報表中新增 value_adjustment 和 all_value_adjustment 指標。
landing_page_source 新增區隔 在 landing_page_view 中提供到達網頁來源區隔。
search_term_match_source 新增區隔 可在搜尋字詞和廣告活動搜尋字詞檢視畫面中選取的區隔。
match_type 新增區隔 關鍵字檢視畫面中可選取的區隔鍵。
不重複查詢意圖群組報表 新欄位 新增 clicks_unique_query_clusters、conversions_unique_query_clusters 和 impressions_unique_query_clusters，用於回報不重複的查詢意圖叢集。
ClickType.VEHICLE_ASSETS 新的列舉值 在 click_view 報表中，追蹤並回報與車輛廣告格式相關的點擊次數。
智慧出價探索
搜尋策略中的容許度設定 新欄位 / 設定 將 target_roas_tolerance_percent_millis 設為介於 10,000 (10%) 和 30,000 (30%) 之間 (含這兩個值)，即可在搜尋廣告活動中啟用智慧出價探索功能 (使用「盡量爭取轉換」出價策略時，必須設定 target_roas)。請參閱有關智慧出價探索的網誌文章和說明中心文章。
多元性報告相容性 新功能 現在系統支援針對不重複的查詢意圖叢集，匯總下列指標的多元性報表。Google Ads 使用者介面提供以時間區隔的檢視畫面：
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
影片
YouTubeVideoListAsset 新資源 / 欄位 可使用 Asset.youtube_video_list_asset 在廣告活動和影片清單資產之間建立連結。請參閱「使用相關影片」。
洞察中繼資料擴充功能 新欄位 已將新中繼資料新增至 YouTubeChannelInsights 和 YouTubeVideoAttributeMetadata。
互動式點擊類型 新的列舉值 新增點擊類型：VIDEO_RELATED_VIDEOS_CLICK、VIDEO_CHANNEL_CLICK 和 PRODUCT_ASSETS。
VideoAdInventoryControl.allow_non_skippable_in_stream 新欄位 如果廣告活動同時採用可略過和不可略過的格式，系統會將影片回應式廣告放送為不可略過的串流內廣告。
影片序列設定 新欄位 新增唯讀排序設定：Campaign.VideoCampaignSettings.video_ad_sequence 和 VideoAdSequenceStepSetting。請參閱「影片廣告序列簡介」。
影片首選頻道指定目標 新的條件類型 / 欄位 在 CampaignCriterion 和 AdGroupCriterion 中新增 VIDEO_LINEUP 條件類型和對應欄位。這項功能僅適用於已加入許可清單的帳戶。
內容合適度刊登位置瀏覽次數 全新報表資源 新增詳細資料 (detail_content_suitability_placement_view) 和群組 (group_content_suitability_placement_view) 層級的內容合適度報表。請參閱「『內容合適度』報表簡介」。

封存的版本資訊

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