本頁面提供 Google 出價管理工具 API 的版本資訊。
最新 API 版本：v2
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
建立匿名廣告空間模型 (AIM) 報表維度的時間表
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
使用 params.type 為 YOUTUBE 的 Query 資源建立或執行，並在 params.metrics 中傳回相關指標值，會傳回 400 錯誤。
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 進行結構性變更，包括更新服務端點，以及重新命名服務和方法。
大幅更新查詢和報表資源，方法是移除不必要的欄位、重新整理現有欄位，以及變更欄位類型。包括變更欄位類型，以便使用命名物件，而非一般「巢狀物件」定義。
必須使用 queries.run 方法執行臨時查詢，而非在建立後自動執行。
將 queries.run 查詢參數 asynchronous 替換為 synchronous。
透過下列變更簡化報表擷取作業：
- 新增
queries.reports.get方法。 - 將
orderBy查詢參數新增至queries.reports.list。 - 將
queries.run回應主體從空物件更新為產生的Report資源例項。
更新 API 傳回的錯誤訊息，使其更具體，並提供更明確的解決方案。
請按照第 2 版遷移指南中的操作說明，從第 1.1 版遷移至第 2 版。
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 的先前版本，請參閱封存的版本資訊。