上次更新日期:2023 年 10 月 31 日
迁移应用
从 v2 迁移到 v3 需要将端点网址更新为调用 v3,并更新应用以考虑破坏性更改。
将您的 API 调用从 v2 更新为 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 中引入了一些破坏性更改。请查看以下说明,并根据您当前使用 Display & Video 360 API 的情况进行必要的更改。
更新检索 YouTube 资源及其相关定位条件的调用
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
对象的引用已移至常规BiddingStrategy
对象中的新youtubeAndPartnersBid
字段。biddingStrategy
字段已从YoutubeAndPartnersSettings
对象中移除。更新您的集成,从LineItem
或AdGroup
资源bidStrategy
字段中的BiddingStrategy
对象中检索 YouTube 订单项或广告组的出价策略。 YoutubeAndPartnersSettings
对象中的thirdPartyMeasurementSettings
字段已重命名为thirdPartyMeasurementConfigs
,YoutubeAndPartnersThirdPartyMeasurementSettings
对象已重命名为ThirdPartyMeasurementConfigs
。更新您的集成,使用新的字段和对象检索第三方衡量配置信息。
创建广告客户时添加所需的结算配置
billingConfig
现在是 Advertiser
资源中的必填字段。更新您的 advertisers.create
请求,以验证是否已设置此字段。您可以通过新的 Partner
资源 billingConfig
字段检索父级合作伙伴的默认结算信息。
使用新字段控制优化型定位
新的布尔值 enableOptimizedTargeting
字段取代了 TargetingExpansionConfig
对象中的 targetingExpansionLevel
字段。
更新广告订单集成以使用新的 KPI 字段
新的 kpi
字段取代了 InsertionOrder
资源中的 performanceGoal
字段。此新字段使用 Kpi
对象代替 PerformanceGoal
对象,并使用新的字段和枚举。
移除对已弃用服务和字段的引用
为了与过去的功能弃用保持一致,v3 中移除了多个实体:
- 由于手动触发器已弃用,
advertisers.manualTriggers
服务已被移除。 billableOutcome
字段已从InsertionOrder
资源中移除,因为按结果付费已被废弃。
其他更改
除了上面列出的重大变更之外,v3 还引入了新功能。
请参阅我们的版本说明,了解首次发布后 v3 中添加的功能。
邻近地理位置列表管理
在 v3 中,您可以全面管理邻近区域营业地点列表,从而使用 advertisers.locationLists.assignedLocations
服务创建和删除分配给 TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
资源的位置。营业地点使用 TARGETING_TYPE_POI
TargetingOption
资源的 ID 进行标识。这些信息可以使用 targetingTypes.targetingOptions.search
进行检索。
能够构建基于规则的自定义出价算法
在 v3 中,您可以使用 customBiddingAlgorithms
、media
、customBiddingAlgorithms.rules
服务构建和检索基于规则的自定义出价算法。
此功能目前处于 Beta 版阶段,仅供列入许可名单的合作伙伴使用。如果您的合作伙伴不在许可名单中,您的请求将返回错误。