版本資訊

如需目前和預計淘汰功能的最新清單，請參閱「功能淘汰項目」。

v25 主要和次要版本

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

v25.2 (2026-09-23)

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

功能與更新 類型 說明
素材資源
「AssetGroup」的網址選項 新欄位 新增對AssetGroup網址選項的支援，讓廣告主在素材資源群組層級指定追蹤範本、自訂參數和最終到達網址尾碼：
廣告活動
自動影片檢索資訊 新欄位和列舉 新增 AutomatedVideoCrawlSetting 至 Campaign.AssetAutomationSetting，以及 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，以百分位數層級格式提供指標，代表顧客在其他廣告主中的競爭地位。指標會傳回至新 CustomerMetrics.percentile_metrics 欄位 (位於 GenerateBenchmarksMetricsResponse.customer_metrics 和 BreakdownMetrics.customer_metrics) 的 PercentileMetrics，並以 BenchmarksCustomerPercentileTier 表示。

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

在 ListBenchmarksAvailableDatesResponse.supported_dates (由 BenchmarksService.ListBenchmarksAvailableDates 傳回) 中，新增對未結算季度日期百分位數指標的支援。雖然客戶匯總指標 (CustomerMetrics.aggregate_metrics)、客戶比率指標 (CustomerMetrics.average_rate_metrics) 和客戶百分位數指標 (CustomerMetrics.percentile_metrics) 支援 supported_dates 中的所有日期 (包括未結算季度)，但未結算季度不支援客戶市占率指標 (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 選取)：

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 在 v25、v24 和 v23 中現在完全可變動。
廣告活動
會員留存率目標 新功能 / 設定 新增會員回訪率目標支援，廣告主可藉此將廣告活動最佳化，以留住會員方案成員。
新獲客目標介面 新功能 / 設定 更新 Google Ads API 中的獲客目標支援，以反映經過修訂的統一目標結構：
轉換
YouTube 第三方轉換歸因 新欄位 新增支援功能，可透過第三方合作夥伴驗證 YouTube 轉換歸因： 詳情請參閱這篇說明中心文章。
一般
ContactDetails.phone_number_extension 新欄位 已新增至 LocalServicesLead 資源。
IncentiveError 新的列舉值和錯誤 新增獎勵兌換失敗的特定錯誤代碼：
規劃
熱門趨勢洞察資料中的 YouTube 頻道詳細資料 新欄位 搜尋熱門洞察時，新增支援相關影片的更多 YouTube 頻道詳細資料。已將新欄位 channel_id、channel_name 和 channel_url 新增至 YouTubeVideoAttributeMetadata。
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。

為協助您規劃即將推出的第 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。
選用 videos、business_name 和 logo_images (位於 VideoResponsiveAdInfo 中) 必填欄位 行為改變 建立或變更影片回應式廣告時，請提供 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 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 中新增 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 中，以新的 trueview_views 欄位取代對 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 天內發布過直播。
可規劃的 CRM 來源中繼資料 新訊息 在 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 (每次曝光的平均長度)。

封存的版本資訊

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