本頁提供 Google Bid Manager API 的版本資訊。
最新 API 版本：v2
2024 年 10 月 1 日
新功能
無。
已知問題
v2
停用匿名廣告空間模型 (AIM) 報表維度
FILTER_ANONYMOUS_INVENTORY_MODELING 維度已停用。
正在建立或執行 Query
使用停用值的資源
params.groupBy
會傳回 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
正在建立或執行 Query
以及含有
params.type/
YOUTUBE和相關指標值
params.metrics
傳回 400 錯誤。
2024 年 5 月 1 日
新功能
無。
已知問題
v2
「完整路徑」和「路徑歸因報表」停用
「完整路徑」和「路徑歸因」報表即將停用。擷取或建立這些項目
「Query」和「類型」
Report 資源
則會發生錯誤。
下列
ReportType 的值是
日落：
FULL_PATHPATH_ATTRIBUTION
pathQueryOptions敬上
欄位
Options 物件也
日落。
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 第 2 版。
對 API 進行結構變更，包括更新服務 端點和重新命名服務和方法。
透過以下項目大幅更新查詢和報表資源： 移除不必要的欄位、重新整理現有欄位及變更欄位 。包括變更欄位類型，改用具名物件來取代 一般的「巢狀物件」定義
必須使用 queries.run 方法執行臨時查詢
而不是讓它們在建立完成後自動執行
已將 queries.run 查詢參數 asynchronous 取代為
synchronous。
透過下列變更簡化報表擷取作業：
- 新增
queries.reports.get方法。 - 將
orderBy查詢參數加到queries.reports.list。 - 將空白物件中的
queries.run回應主體更新為 所產生Report資源的執行個體。
更新 API 傳回的錯誤訊息，提供更明確的錯誤訊息 指示性解決方案
按照 v2 遷移指南中的指示操作， 從 1.1 版遷移至第 2 版。
v2
服務端點已變更：
v1 服務端點 v2 服務端點 https://www.googleapis.com/doubleclickbidmanagerhttps://doubleclickbidmanager.googleapis.com服務名稱更改如下：
v1 服務 v2 服務 查詢 查詢 報表 queries.reports 方法已重新命名，如下所示：
已新增下列方法：
服務 方法 queries.reports 取得 下列方法具有新的回應主體：
方法 新增回應主體物件 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 的相關資訊，請參閱 封存的版本資訊。