本頁提供 Google 出價管理工具 API 的版本資訊。
最新 API 版本：v2
2025 年 9 月 22 日
已知問題
由於使用率偏低，我們將淘汰三種 Filter 列舉值，這項異動已在 Display & Video 360 說明中心公告。
v2
下列
Filters已淘汰：Filter值FILTER_DFP_ORDER_IDFILTER_INSERTION_ORDERFILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER
2025 年 3 月 1 日
已知問題
如先前在 Display & Video 360 說明中心公告，YouTube TrueView 廣告空間供應情況報表和相關維度即將停用。
v2
下列列舉值已淘汰：
列舉 值 ReportTypeINVENTORY_AVAILABILITY下列篩選器已淘汰：
篩選條件值 FILTER_DETAILED_DEMOGRAPHICSFILTER_DETAILED_DEMOGRAPHICS_IDFILTER_HOUSEHOLD_INCOMEFILTER_LIFE_EVENTFILTER_REMARKETING_LISTFILTER_TRUEVIEW_IAR_AGEFILTER_TRUEVIEW_IAR_CATEGORYFILTER_TRUEVIEW_IAR_CITYFILTER_TRUEVIEW_IAR_COUNTRYFILTER_TRUEVIEW_IAR_COUNTRY_NAMEFILTER_TRUEVIEW_IAR_GENDERFILTER_TRUEVIEW_IAR_INTERESTFILTER_TRUEVIEW_IAR_LANGUAGEFILTER_TRUEVIEW_IAR_PARENTAL_STATUSFILTER_TRUEVIEW_IAR_REGION_NAMEFILTER_TRUEVIEW_IAR_REMARKETING_LISTFILTER_TRUEVIEW_IAR_TIME_OF_DAYFILTER_TRUEVIEW_IAR_YOUTUBE_CHANNELFILTER_TRUEVIEW_IAR_YOUTUBE_VIDEOFILTER_TRUEVIEW_IAR_ZIPCODEFILTER_YOUTUBE_CHANNELFILTER_YOUTUBE_VIDEO下列指標已淘汰：
指標值 METRIC_POTENTIAL_VIEWSMETRIC_TEA_TRUEVIEW_IMPRESSIONSMETRIC_TEA_TRUEVIEW_UNIQUE_COOKIES
2024 年 11 月 20 日
新功能
FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID已推出。這樣一來，系統就會納入可信度較低的資料，用於計算下列前置字元的指標：
METRIC_UNIQUE_REACH_METRIC_VIRTUAL_PEOPLE_DUPLICATE_METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_METRIC_VIRTUAL_PEOPLE_OVERLAP_
使用這項篩選器時，必須納入其中一項相關指標。
推出後，如果查詢未納入這項篩選器，系統會預設只納入高可信度資料，與先前的預設行為相同。自 2025 年 2 月 4 日起，如果查詢未納入這項篩選器，系統預設會納入低信賴度資料。
v2
已新增下列篩選器：
篩選條件類型 可用的值 FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID0：納入可信度較低的資料。(2025 年 2 月 4 日後為預設值)1：只納入可信度高的資料。(2025 年 2 月 4 日前的預設值)
2024 年 10 月 1 日
新功能
無。
已知問題
v2
「建立匿名廣告空間模型」報表維度即將停用
FILTER_ANONYMOUS_INVENTORY_MODELING 維度已停用。
使用 params.groupBy 中的淘汰值建立或執行 Query 資源時，會傳回 400 錯誤。
「數位服務稅 (DST)/營運規費 (ROC)」和「媒體費用總額」指標不再支援 YOUTUBE 報表。
YOUTUBE 報表不再支援下列指標值：
METRIC_TOTAL_MEDIACOST_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPC_PARTNERMETRIC_TOTAL_MEDIACOST_ECPAPC_USDMETRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPV_PARTNERMETRIC_TOTAL_MEDIACOST_ECPAPV_USDMETRIC_TOTAL_MEDIACOST_ECPA_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPA_PARTNERMETRIC_TOTAL_MEDIACOST_ECPA_USDMETRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPCV_PARTNERMETRIC_TOTAL_MEDIACOST_ECPCV_USDMETRIC_TOTAL_MEDIACOST_ECPC_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPC_PARTNERMETRIC_TOTAL_MEDIACOST_ECPC_USDMETRIC_TOTAL_MEDIACOST_ECPM_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPM_PARTNERMETRIC_TOTAL_MEDIACOST_ECPM_USDMETRIC_TOTAL_MEDIACOST_PARTNERMETRIC_TOTAL_MEDIACOST_USDMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISERMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNERMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USDMETRIC_FEE32_ADVERTISERMETRIC_FEE32_PARTNERMETRIC_FEE32_USD
使用 YOUTUBE 建立或執行 Query 資源，並在 params.metrics 中提供相關指標值，會傳回 400 錯誤。params.type
2024 年 5 月 1 日
新功能
無。
已知問題
v2
「完整路徑」和「路徑歸因」報表即將淘汰
「完整路徑」和「路徑歸因」報表已淘汰。擷取或建立這些類型的 Query 和 Report 資源會導致錯誤。
支援的ReportType值如下：
FULL_PATHPATH_ATTRIBUTION
Options 物件的 pathQueryOptions 欄位也已淘汰。
2024 年 2 月 28 日
新功能
無。
已知問題
v2
跨裝置轉換指標價值即將停用
跨裝置轉換指標已淘汰。系統會納入下列 Bid Manager API 指標值：
METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENTMETRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENTMETRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENTMETRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENTMETRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT
2022 年 7 月 6 日
新功能
發布 Bid Manager API v2。
對 API 進行結構性變更，包括更新服務端點，以及重新命名服務和方法。
大幅更新 Query 和 Report 資源，移除不必要的欄位、重新整理現有欄位，以及變更欄位類型。包括將欄位類型變更為使用具名物件，而非一般「巢狀物件」定義。
您必須使用 queries.run 方法執行臨時查詢，而不是在建立查詢後自動執行。
將 queries.run 查詢參數 asynchronous 替換為 synchronous。
透過下列變更簡化報表擷取作業：
- 新增
queries.reports.get方法。 - 在
queries.reports.list中新增orderBy查詢參數。 - 將
queries.run回應主體從空物件更新為產生的Report資源例項。
更新 API 傳回的錯誤訊息，提供更具體的資訊和解決方法。
請按照 v2 遷移指南中的說明，從 v1.1 遷移至 v2。
v2
服務端點已變更：
v1 服務端點 v2 服務端點 https://www.googleapis.com/doubleclickbidmanagerhttps://doubleclickbidmanager.googleapis.com服務已重新命名，如下所示：
v1 服務 v2 服務 查詢 查詢 報表 queries.reports 方法已重新命名如下：
新增了下列方法：
服務 方法 queries.reports get 下列方法有新的回應內容：
方法 新的回應本文物件 queries.run 檢舉 下列欄位已遭移除：
資源 欄位 queries.list回應主體kind
queries.reports.list回應主體kind
查詢 kind
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
下列欄位的物件類型已變更為：
資源 欄位 物件類型 查詢 檢舉 RunQueryRequest 新增了下列方法查詢參數：
方法 查詢參數 queries.list orderBy queries.reports.list orderBy queries.run 同步 下列方法查詢參數已移除：
方法 查詢參數 queries.create 非同步 queries.run 非同步 已新增下列篩選器值：
篩選條件值 FILTER_INVENTORY_MEDIA_COST_TYPE FILTER_TARGETING_EXPANSION 下列篩選器值已移除：
篩選條件值 FILTER_TRUEVIEW_IAR_REGION 已新增下列指標值：
指標值 METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH
已知問題
無。
舊版本
如要瞭解舊版 Bid Manager API 的版本資訊，請參閱封存的版本資訊。