本页提供了 Google Bid Manager API 的版本说明。
最新 API 版本：v2
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 版本，请参阅我们的已归档的版本说明。