从 Bid Manager API v1.1 迁移到 v2

2022 年 3 月,我们发布了 Bid Manager API 版本 2。由于存在 我们计划尽快公布 v1.1 的停用日期。周三 建议您尽快开始从 v1.1 迁移到 v2。

迁移您的应用

从 v1.1 迁移到 v2 需要更新端点网址以调用 v2,并且 更新您的应用以应对破坏性更改。

将您的 API 调用从 v1.1 更新为 v2

如需使用 v2 来代替 v1.1,您需要更新请求,改用新的 v2 端点。

确定等效方法

要将您的 API 调用从使用 v1.1 更新为使用 v2,您必须先确定 与 v2 中等效的 v1.1 方法相同。

以下所有服务和方法的名称在 v1.1 和 v2:

更新到新端点

确定等效方法后,您需要更新请求。对于 例如,要在 v1.1 中调用 queries.getquery 方法,您应使用 以下网址:

https://www.googleapis.com/doubleclickbidmanager/v1.1/query/queryId

如需调用 v2 中的等效方法(称为 queries.get),请更新 以下网址:

GET https://doubleclickbidmanager.googleapis.com/v2/queries/queryId

如果您使用客户端库向 API 发出请求,请使用 最新版本的客户端库,并将您的配置更新为使用 v2。

进行所需的更改

我们在 v2 中引入了许多破坏性更改。请查看以下内容 对现有使用说明进行必要的更改 Bid Manager API。

更新对 queries 服务的调用

更新对 reports 服务的调用

更新错误处理逻辑

整个 API 中的错误消息在 v2 中已更新。这些新的错误消息 更具体,在某些情况下,还会提供 引发错误的 API 请求。如果现有错误 处理逻辑依赖于特定的错误消息文本,概括您的错误 处理。