本页提供了 Google Bid Manager API 的版本说明。
最新 API 版本：v2
2025 年 9 月 22 日
已知问题
由于使用率较低，我们将停用三个 Filter 枚举值，正如之前在
Display & Video 360 帮助中心中所宣布的那样。
v2
以下
Filters已弃用：Filter值FILTER_DFP_ORDER_IDFILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_INSERTION_ORDERFILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER
2025 年 3 月 1 日
已知问题
我们将停用 YouTube Trueview 广告资源可用性报告和相关 维度，正如之前在 Display & Video 360 帮助 中心中所宣布的那样。
v2
以下过滤条件已弃用：
过滤值 FILTER_DETAILED_DEMOGRAPHICSFILTER_DETAILED_DEMOGRAPHICS_IDFILTER_HOUSEHOLD_INCOMEFILTER_LIFE_EVENTFILTER_REMARKETING_LISTFILTER_TRUEVIEW_IAR_AGEFILTER_TRUEVIEW_IAR_CATEGORYFILTER_TRUEVIEW_IAR_CITYFILTER_TRUEVIEW_IAR_COUNTRYFILTER_TRUEVIEW_IAR_COUNTRY_NAMEFILTER_TRUEVIEW_IAR_GENDERFILTER_TRUEVIEW_IAR_INTERESTFILTER_TRUEVIEW_IAR_LANGUAGEFILTER_TRUEVIEW_IAR_PARENTAL_STATUSFILTER_TRUEVIEW_IAR_REGION_NAMEFILTER_TRUEVIEW_IAR_REMARKETING_LISTFILTER_TRUEVIEW_IAR_TIME_OF_DAYFILTER_TRUEVIEW_IAR_YOUTUBE_CHANNELFILTER_TRUEVIEW_IAR_YOUTUBE_VIDEOFILTER_TRUEVIEW_IAR_ZIPCODEFILTER_YOUTUBE_CHANNELFILTER_YOUTUBE_VIDEO以下 指标 已弃用：
指标值 METRIC_POTENTIAL_VIEWSMETRIC_TEA_TRUEVIEW_IMPRESSIONSMETRIC_TEA_TRUEVIEW_UNIQUE_COOKIES
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 维度已停用。
创建或运行 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
The
pathQueryOptions
object 的
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 进行了结构性更改，包括更新服务端点以及重命名服务和方法。
通过移除不必要的字段、重新整理现有字段和更改字段类型，对 查询和 报告资源进行了重大更新。这包括更改字段类型，以使用命名对象而不是通用的“嵌套对象”定义。
需要使用 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 报告 queries.reports 方法已重命名，如下所示：
添加了以下方法：
服务 方法 queries.reports get 以下方法具有新的响应正文：
方法 新的响应正文对象 queries.run Report 已移除以下字段：
资源 字段 queries.list响应正文kind
queries.reports.list响应正文kind
Query kind
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
以下字段的对象类型已更改为以下类型：
资源 字段 对象类型 Query Report RunQueryRequest 添加了以下方法查询参数：
方法 查询参数 queries.list orderBy queries.reports.list orderBy queries.run synchronous 移除了以下方法查询参数：
方法 查询参数 queries.create asynchronous queries.run asynchronous 添加了以下过滤条件值：
过滤条件值 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 版本，请参阅我们的 归档版本说明。