从 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 中引入了许多破坏性更改。请查看以下内容对现有使用说明进行必要的更改展示广告与Video 360 API。

字段 inventorySourceIds 已被移除。管理使用 AssignedTargetingOption 资源分配广告资源来源共 TARGETING_TYPE_INVENTORY_SOURCE 个。
以下 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 中的功能，版本说明。

在 v2 中，可以使用以下代码检索 YouTube 订单项及其定位设置 advertisers.lineItems和 advertisers.lineItems.targetingTypes.assignedTargetingOptions 服务。该 API 提供只读访问，也就是说，尝试写入这些订单项时，系统将返回错误。YouTube 订单项将属于以下类别之一：LineItemType 值：

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

您可以使用 advertisers.lineItems.bulkUpdate 设置相同的字段值。只有目前支持 entityStatus 字段。
您可以使用 advertisers.lineItems.bulkEditAssignedTargetingOptions 在多个行中添加或移除相同的已分配定位选项项。
您可以使用 advertisers.lineItems.bulkListAssignedTargetingOptions 来列出多个订单项中分配的定位选项。
您可以使用 advertisers.lineItems.duplicate 创建副本同一广告订单中现有订单项的多个副本，并将所有配置和定位设置

在 v2 中，您可以修改 InsertionOrder 的部分定位设置使用新的 create 和 delete 方法（位于 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 服务。以下定位类型可在插入时完全进行管理订单级：