版本資訊

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

v25 主要和次要版本

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

v25.1 (2026-08-19)

Google Ads API v25.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 強化功能 新功能 新增類別做為篩選器，可縮小基準分析的範圍。此外，還支援其他重要業務指標：
家長狀態指定目標 新功能 觸及規劃工具現在支援指定家長狀態。新欄位 parental_statuses 已新增至服務 ReachPlanService.GenerateReachForecast 的 Targeting，而 parental_statuses 已新增至服務 ReachPlanService.ListPlannableProducts 的 PlannableTargeting。
建議
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。
合成內容資訊可變動性 行為變更 在第 25 版、第 24 版和第 23 版中，Asset.synthetic_content_info 和 Ad.synthetic_content_info 現在完全可變動。
廣告活動
忠誠度留存目標 新功能 / 設定 新增會員留存目標支援，廣告主可藉此最佳化廣告活動，留住會員方案成員。
新獲客目標介面 新功能 / 設定 更新 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。

為協助您規劃即將推出的第 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。
KeywordPlanIdeaService.GenerateKeywordForecastMetrics 中的 geo_modifiers 和 biddable_keywords 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_ruleSharedCriterion中新增vertical_ads_item_group_rule_list條件類型，允許在旅遊動態饋給的搜尋廣告活動中指定目標項目群組。
整合直向廣告資料動態饋給 新功能 現在可將產業廣告資料動態饋給連結至放送 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 新的報表資源 在報表指標中新增 TargetingExpansionView，用於手動指定目標的擴展功能，例如 AI Max 搜尋廣告活動的無關鍵字擴展功能。
Google 購物
修正購物範圍 修正錯誤 修正 ShoppingProduct 資源中指標的廣告活動和廣告群組範圍。
統一目標
留存率目標 新功能 新增支援顧客留存率目標，可盡量爭取回訪顧客 (例如使用 target_option 搭配 TARGET_SPECIFIC 或 TARGET_ALL)。
影片
影片觀看時間指標 新欄位 新增觀看時間長度指標：video_watch_time_duration_millis (總長度) 和 average_video_watch_time_duration_millis (每次曝光的平均長度)。

封存的版本資訊

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