从 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