本页提供了 Google Bid Manager 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
创建或运行 Query 资源时，如果 params.type 为 YOUTUBE，并且 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方法。 - 向
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 版本，请参阅归档的版本说明。