本页提供了 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
以下枚举值已弃用：
枚举 值 ReportTypeINVENTORY_AVAILABILITY以下过滤条件已弃用：
过滤条件值 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 维度已停用。
使用 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 进行了结构性更改，包括更新服务端点以及重命名服务和方法。
通过移除不必要的字段、重新整理现有字段和更改字段类型，大幅更新了 Query 和 Report 资源。这包括将字段类型更改为使用命名对象，而不是使用常规的“嵌套对象”定义。
需要使用 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，请参阅我们的归档版本说明。