本页提供了 Google Bid Manager API 的版本说明。
最新 API 版本：v2
2024 年 10 月 1 日
新功能
无。
已知问题
v2
匿名广告资源建模 (AIM) 报表维度即将停用
FILTER_ANONYMOUS_INVENTORY_MODELING维度已停用。
正在创建或运行Query
在 Google Cloud 中
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 v2。
对 API 进行了结构性更改，包括更新服务 端点以及重命名服务和方法
对 Query 和 Report 资源进行了大幅更新， 移除不必要的字段、重新整理现有字段以及更改字段 。这包括将字段类型更改为使用已命名的对象，而不是 常规“嵌套对象”定义。
需要使用 queries.run 方法运行临时查询
而不是在创建后自动运行
将 queries.run 查询参数 asynchronous 替换为了
synchronous。
通过以下更改简化了报告检索：
- 添加了
queries.reports.get方法。 - 将
orderBy查询参数添加到queries.reports.list。 - 将
queries.run响应正文从空对象更新为 生成的Report资源的实例。
更新了 API 返回的错误消息，使其更加具体，并提供更多信息 说明性解决方案。
按照 v2 迁移指南中显示的说明操作， 从 v1.1 迁移到 v2。
v2
服务端点已更改：
v1 服务端点 v2 服务端点 https://www.googleapis.com/doubleclickbidmanagerhttps://doubleclickbidmanager.googleapis.comService 已按如下方式重命名：
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 版本，请参阅我们的 已归档的版本说明。