从 v1 迁移到 v2

上次更新日期:2022 年 12 月 6 日

迁移应用

从 v1 迁移到 v2 需要将端点网址更新为调用 v2,并更新应用以考虑破坏性更改。

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

如需使用 v2 而不是 v1,您需要将请求更新为使用新的 v2 端点。

例如,如需使用 v1 调用 advertisers.get 方法,请使用以下网址:

GET https://displayvideo.googleapis.com/v1/advertisers/advertiserId

对于 v2,请将网址更新为以下内容:

GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId

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

进行所需的更改

我们在 v2 中进行了多项破坏性更改。请查看以下说明,并根据您当前使用 Display & Video 360 API 的情况进行必要的更改。

更新对定位方式的调用

更新对 advertisers.lineItems 服务的调用

更新对 customBiddingAlgorithms 服务的调用

customBiddingAlgorithmStatemodelReadiness 字段已替换为 modelDetails 字段,该字段可为每个广告主(通过 CustomBiddingModelDetails 对象列表提供访问权限)提供现有算法模型的就绪暂停状态。

其他更改

除了上面列出的重大变更之外,v2 还引入了新功能。

如需了解初始发布之后添加到 v2 的功能,请参阅我们的版本说明

对 YouTube 订单项的只读权限

在 v2 中,可以分别使用 advertisers.lineItemsadvertisers.lineItems.targetingTypes.assignedTargetingOptions 服务检索 YouTube 订单项及其定位设置。该 API 提供只读访问权限,这意味着向这些订单项发出的任何尝试写入请求都将返回错误。YouTube 订单项将采用以下任一 LineItemType 值:

可提升效果的新方法

在 v2 中,advertisers.lineItems 服务提供了新方法来代替批量请求,以提高性能并减少配额消耗:

广告订单定位的部分写入权限

在 v2 中,您可以使用 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 服务中的新 createdelete 方法修改 InsertionOrder 资源的子集定位设置。您可以在广告订单级对以下定位类型进行全代管式管理:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_BROWSER
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_CHANNEL
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
  • TARGETING_TYPE_OPERATING_SYSTEM
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIEWABILITY