本页提供了 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_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPAPC_PARTNER
METRIC_TOTAL_MEDIACOST_ECPAPC_USD
METRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPAPV_PARTNER
METRIC_TOTAL_MEDIACOST_ECPAPV_USD
METRIC_TOTAL_MEDIACOST_ECPA_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPA_PARTNER
METRIC_TOTAL_MEDIACOST_ECPA_USD
METRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPCV_PARTNER
METRIC_TOTAL_MEDIACOST_ECPCV_USD
METRIC_TOTAL_MEDIACOST_ECPC_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPC_PARTNER
METRIC_TOTAL_MEDIACOST_ECPC_USD
METRIC_TOTAL_MEDIACOST_ECPM_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPM_PARTNER
METRIC_TOTAL_MEDIACOST_ECPM_USD
METRIC_TOTAL_MEDIACOST_PARTNER
METRIC_TOTAL_MEDIACOST_USD
METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISER
METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNER
METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USD
METRIC_FEE32_ADVERTISER
METRIC_FEE32_PARTNER
METRIC_FEE32_USD
创建或运行 Query
资源时,如果 params.type
为 YOUTUBE
,并且 params.metrics
中存在相关指标值,则会返回 400
错误。
2024 年 5 月 1 日
新功能
无。
已知问题
v2
完整路径和路径归因报告即将停用
“完整路径”报告和“路径归因”报告即将停用。检索或创建这类 Query
和 Report
资源会导致错误。
以下 ReportType
值将弃用:
FULL_PATH
PATH_ATTRIBUTION
Options
对象的 pathQueryOptions
字段也已弃用。
2024 年 2 月 28 日
新功能
无。
已知问题
v2
跨设备转化指标值的弃用
跨设备转化指标即将停用。包含以下 Bid Manager API 指标值:
METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENT
METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
METRIC_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/doubleclickbidmanager
https://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 版本,请参阅我们的已归档的版本说明。