从 v2 迁移到 v3

上次更新日期：2023 年 10 月 31 日

迁移您的应用

从 v2 迁移到 v3，需要更新端点网址以调用 v3，更新您的应用以应对破坏性更改。

如需使用 v3 代替 v2，您需要更新请求，改用新的 v3 端点。

例如，要使用 v2 调用 advertisers.get 方法，您应请使用以下网址：

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

对于 v3，请将网址更新为以下内容：

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

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

我们在 v3 中引入了许多破坏性更改。请查看以下内容对现有使用说明进行必要的更改展示广告与Video 360 API。

YoutubeAdGroup 和 YoutubeAdGroupAd 资源已被替换为 AdGroup 和 AdGroupAd 资源。这些新资源提供了与 v2 资源的信息几乎完全相同，但可以使用更新后的字段名称或枚举类型。在集成中，替换您对 YoutubeAdGroup 或 YoutubeAdGroupAd 资源（含 AdGroup 和 AdGroupAd 资源，并将对以下 v2 服务的调用更新为相应的 v3 服务：
- advertisers.youtubeAdGroupAds 到 advertisers.adGroupAds
- advertisers.youtubeAdGroups 到 advertisers.adGroups
- advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions至 advertisers.adGroups.targetingTypes.assignedTargetingOptions
对 YoutubeAndPartnersBiddingStrategy 对象的引用已移至新的youtubeAndPartnersBid字段在常规 BiddingStrategy 对象中。通过 biddingStrategy字段已从 YoutubeAndPartnersSettings 对象。将您的集成更新为请检索 YouTube 订单项或广告组的出价策略 BiddingStrategy 对象中bidStrategy LineItem 或 AdGroup 资源。
thirdPartyMeasurementSettings 字段已重命名为 thirdPartyMeasurementConfigs（位于 YoutubeAndPartnersSettings 对象和已将 YoutubeAndPartnersThirdPartyMeasurementSettings 对象重命名为 ThirdPartyMeasurementConfigs。将您的集成更新为使用新的字段检索第三方衡量配置信息和对象。

现在，billingConfig 是 Advertiser 资源。更新你的advertisers.create 请求验证此字段是否已设置。默认结算信息可以通过新的 Partner 为父级合作伙伴检索。资源 billingConfig 字段中的值。

新的布尔值enableOptimizedTargeting字段已取代 TargetingExpansionConfig 中的 targetingExpansionLevel 字段对象。

新的 kpi 字段取代了performanceGoal InsertionOrder 资源。这个新字段使用 Kpi 对象来代替 PerformanceGoal 对象，并使用新的字段和枚举。

除了上面列出的破坏性更改之外，v3 还引入了功能。

在 v3 中，您可以全面管理邻近区域地理位置列表，从而执行以下操作：使用 advertisers.locationLists.assignedLocations 服务创建和删除分配给TARGETING_LOCATION_TYPE_PROXIMITY的位置 LocationList 资源。地理位置使用 TARGETING_TYPE_POI TargetingOption 资源。这些可以是使用 targetingTypes.targetingOptions.search 检索。

此功能目前处于 Beta 版阶段，仅供列入许可名单的合作伙伴使用。如果您的合作伙伴未列入许可名单，您的请求将返回错误。