从 v1 迁移到 v2

上次更新时间：2022 年 12 月 6 日

迁移应用

从 v1 迁移到 v2 需要更新端点网址以调用 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 的使用情况进行必要的更改。

inventorySourceIds 字段已移除。使用 TARGETING_TYPE_INVENTORY_SOURCE 的 AssignedTargetingOption 资源管理商品目录来源分配。
以下 LineItemWarningMessage 枚举值已在 v2 中废弃，并且不会再显示在 LineItem.warningMessages 中：
- NO_POSITIVE_AUDIENCE_LIST_TARGETED
- APP_INSTALL_NO_CONVERSION_PIXEL
- TARGETING_REVOKED_OR_CLOSED_USER_LIST
- APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
- CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
- NO_CREATIVE_FOR_TARGETED_DEALS
- TARGETING_DEPRECATED_GEO_TARGET
triggerId 字段已从 LineItemFlight 对象中移除，LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER 值已从 LineItemFlightDateType 枚举类型中移除。v2 不支持根据手动触发器的启用情况设置订单项支出。

customBiddingAlgorithmState 和 modelReadiness 字段已替换为 modelDetails 字段，该字段会为通过 CustomBiddingModelDetails 对象列表拥有访问权限的每个广告客户提供现有算法模型的就绪和暂停状态。

除了上述破坏性更改之外，v2 还引入了新功能。

在首次发布后添加到 v2 中的功能可在版本说明中找到。

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

在 v2 中，advertisers.lineItems 服务提供了可替代批量请求的新方法，以便提高性能并减少配额消耗：

您可以使用 advertisers.lineItems.bulkUpdate 为多个订单项设置相同的字段值。目前仅支持更新 entityStatus 字段。
您可以使用 advertisers.lineItems.bulkEditAssignedTargetingOptions 在多个订单项中添加或移除相同的指定定位选项。
您可以使用 advertisers.lineItems.bulkListAssignedTargetingOptions 列出多个订单项中分配的定位选项。
您可以使用 advertisers.lineItems.duplicate 在同一广告订单中复制现有订单项，并复制所有配置和定位设置。

在 v2 中，您可以使用 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 服务中的新 create 和 delete 方法修改 InsertionOrder 资源的部分定位设置。以下定位类型可在广告订单一级进行全面管理：