本页提供了 Display & Video 360 API 的版本说明。
最新 API 版本：v3
2024 年 12 月 4 日
新功能
添加了对 Core 和 Tubi Exchange 值的支持。
将 firstAndThirdPartyAudiences.list 的允许最大页面大小从 200 增加到了 5000。更新 firstAndThirdPartyAudiences.list 请求的 pageSize 参数，以进一步优化配额用量。
v3
添加了以下枚举值：
枚举 值 ExchangeEXCHANGE_COREEXCHANGE_TUBI以下列表方法的最大页面大小已增加：
方法 新的最大页面大小 firstAndThirdPartyAudiences.list5000
2024 年 10 月 22 日
新功能
添加了对每次观看费用效果目标的支持。
添加了设置和检索已连接设备的定位条件的功能。
在第三方验证方定位下添加了新的 Adloox 品牌保障设置。
添加了对下载 v8 结构化数据文件的支持，该功能目前处于封闭式 Beta 版测试阶段。
v3
添加了以下字段：
对象 字段 AdlooxcrimeHarmfulActsIndividualsSocietyHumanRightsViolationsContentdeathInjuryMilitaryConflictContentdebatedSensitiveSocialIssueContenthateSpeechActsAggressionContent添加了以下枚举值：
枚举 值 DeviceTypeDEVICE_TYPE_CONNECTED_DEVICEPerformanceGoalTypePERFORMANCE_GOAL_TYPE_CPVSdfVersionSDF_VERSION_8
已废弃的值
移除了对 SDF v5.5 的支持，因为该版本将于 2024 年 10 月 3 日弃用。
v3
以下枚举值已废弃：
枚举 值 SdfVersionSDF_VERSION_5_5
2024 年 8 月 15 日
新功能
添加了对 Netflix Exchange 类型的支持。
v3
添加了以下枚举值：
枚举 值 广告交易平台 EXCHANGE_NETFLIX
v2
添加了以下枚举值：
枚举 值 广告交易平台 EXCHANGE_NETFLIX
2024 年 7 月 15 日
新功能
在 v3 中添加了对以 QA 格式下载订单项和广告组结构化数据文件的支持。
v3
2024 年 6 月 17 日
新功能
添加了对管理在广告客户一级分配的关键字定位的支持。
向广告订单资源添加了新的 optimizationObjective 字段。optimizationObjective 仅面向列入许可名单的客户提供。
v3
添加了以下字段：
资源 字段 InsertionOrder 以下方法现在支持以下定位类型：
v2
以下方法现在支持以下定位类型：
2024 年 5 月 30 日
新功能
添加了对结构化数据文件 (SDF) 7.1 版的支持。
v3
添加了以下枚举值：
枚举 值 SdfVersion SDF_VERSION_7_1
v2
添加了以下枚举值：
枚举 值 SdfVersion SDF_VERSION_7_1
2024 年 4 月 23 日
新功能
添加了对新 KPI 类型、广告交易平台和应用平台的支持。
v3
添加了以下字段：
资源 字段 KPI 添加了以下枚举值：
枚举 值 AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
广告交易平台 EXCHANGE_DRAX
KpiType KPI_TYPE_CPCL
KPI_TYPE_CPCV
KPI_TYPE_CPV
KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST
KPI_TYPE_MAXIMIZE_PACING
KPI_TYPE_TOS10
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
v2
添加了以下枚举值：
枚举 值 AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
广告交易平台 EXCHANGE_DRAX
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
2024 年 2 月 28 日
新功能
添加了从目标客户匹配受众群体中明确移除成员的功能。
添加了对定位到新广告交易平台的支持。
v3
添加了以下字段：
资源 字段 firstAndThirdPartyAudiences.editCustomerMatchMembers 添加了以下枚举值：
枚举 值 广告交易平台 EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
v2
添加了以下字段：
资源 字段 firstAndThirdPartyAudiences.editCustomerMatchMembers 添加了以下枚举值：
枚举 值 广告交易平台 EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
2024 年 1 月 29 日
新功能
添加了通过新的 floodlightGroups.floodlightActivities 服务检索 Floodlight 活动的功能。
添加了一个新字段，用于指明 YouTube 及合作伙伴订单项的定位条件中是否包含 Google TV 广告资源。
添加了一个新字段，用于传递 Display & Video 360 用户的上次登录时间。
v3
添加了以下方法：
服务 方法 floodlightGroups.floodlightActivities 添加了以下字段：
资源 字段 用户 YoutubeAndPartnersInventorySourceConfig
v2
添加了以下方法：
服务 方法 floodlightGroups.floodlightActivities 添加了以下字段：
资源 字段 用户 YoutubeAndPartnersInventorySourceConfig
2023 年 11 月 14 日
新功能
在所有正式版中，添加了在上传客户匹配受众群体成员时传递最终用户意见征求的支持。
v3
添加了以下字段：
资源 字段 ContactInfoList MobileDeviceIdList
v2
添加了以下字段：
资源 字段 ContactInfoList MobileDeviceIdList
2023 年 10 月 31 日
新功能
将 v3 从公开 Beta 版移至正式版。
重命名了 v3 中的 AdGroupFormat 枚举值，以更准确地反映相关格式。
添加了对结构化数据文件 v7 的支持，并在 v2 和 v3 中添加了 SDF_VERSION_7 枚举值。
v3
移除了以下枚举值：
枚举 值 AdGroupFormat AD_GROUP_FORMAT_ACTION
添加了以下枚举值：
枚举 值 AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
添加了以下枚举值：
枚举 值 SdfVersion SDF_VERSION_7
2023 年 10 月 2 日
新功能
发布了 v3 公开 Beta 版，其中包括以下变更：
- 能够全面管理邻近位置列表，从而使用
advertisers.locationLists.assignedLocations服务创建和删除分配给TARGETING_LOCATION_TYPE_PROXIMITYLocationList资源的位置。 - 一个新的布尔值
enableOptimizedTargeting字段，用于替换TargetingExpansionConfig对象中的targetingExpansionLevel字段。 Advertiser资源中的billingConfig字段要求（在发出advertisers.create请求时必须包含此字段），以及Partner资源中的新billingConfig字段。- 新的
AdGroup和AdGroupAd资源，用于替换 v2 中的YoutubeAdGroup和YoutubeAdGroupAd资源。
请按照迁移指南中的步骤从 v2 迁移到 v3。
在 v2 和 v3 中添加了对 3 个新 LineItemType 值、1 个新 YoutubeAndPartnersBiddingStrategyType 和 1 个新 PartnerCostType 的支持。
v3
添加了以下方法：
服务 方法 advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules 移除了以下方法：
服务 方法 advertisers.manualTriggers 启用
create
停用
get
list
patch
advertisers.youtubeAdGroupAds get
list
advertisers.youtubeAdGroups bulkListAdGroupAssignedTargetingOptions
get
list
advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions get
list
以下方法的行为已发生变化：
方法 更改 advertisers.locationLists.create 现在支持创建 TARGETING_LOCATION_TYPE_PROXIMITYLocationList资源。advertisers.locationLists.patch 现在支持更新 TARGETING_LOCATION_TYPE_PROXIMITYLocationList资源。advertisers.locationLists.assignedLocations.bulkEdit 现在支持批量修改 TARGETING_LOCATION_TYPE_PROXIMITYLocationList资源中的AssignedLocation资源。advertisers.locationLists.assignedLocations.create 现在支持在 TARGETING_LOCATION_TYPE_PROXIMITYLocationList资源中创建AssignedLocation资源。添加了以下查询参数：
方法 参数 inventorySources.get 以下字段已设为必填字段：
资源 字段 广告客户 添加了以下字段：
资源 字段 BiddingStrategy InsertionOrder 合作伙伴 TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig 已移除以下字段：
资源 字段 InsertionOrder performanceGoal
billableOutcome
TargetingExpansionConfig excludeFirstPartyAudience
targetingExpansionLevel
YoutubeAndPartnersSettings biddingStrategy
thirdPartyMeasurementSettings
YoutubeAndPartnersInventorySourceConfig includeYoutubeSearch
includeYoutubeVideos
添加了以下枚举值：
枚举 值 CustomBiddingAlgorithmType RULE_BASED
LineItemType LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
PartnerCostType PARTNER_COST_TYPE_SCIBIDS_FEE
ReadinessState READINESS_STATE_EVALUATION_FAILURE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
移除了以下枚举值：
枚举 值 LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
添加了以下枚举值：
枚举 值 LineItemType LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
PartnerCostType PARTNER_COST_TYPE_SCIBIDS_FEE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
2023 年 8 月 25 日
新功能
添加了对两个广告交易平台和两种新的 YouTube 及合作伙伴出价策略类型的支持。
向 YouTube 及合作伙伴订单项添加了新的 effectiveContentCategory 字段，以便在考虑广告客户级和订单项级分配的值时显示订单项使用的 YoutubeAndPartnersContentCategory。
v2
添加了以下字段：
资源 字段 YoutubeAndPartnersSettings 已移除以下字段：
资源 字段 InventorySource subSitePropertyId
添加了以下枚举值：
枚举 值 广告交易平台 EXCHANGE_HIVESTACK
EXCHANGE_RESET_DIGITAL
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS
2023 年 6 月 5 日
新功能
在 v1 和 v2 中为结构化数据文件 (SDF) v6 添加了新的 SdfVersion 值。
v2
添加了以下枚举值：
枚举 值 SdfVersion SDF_VERSION_6
v1
添加了以下枚举值：
枚举 值 SdfVersion SDF_VERSION_6
2023 年 3 月 9 日
新功能
添加了新的 LineItemWarningMessage 值，如果订单项的 excludeFirstPartyAudience 字段已设为 true，系统会将该值分配给订单项的 warningMessages 字段。excludeFirstPartyAudience 字段将于 2023 年 3 月 25 日之后弃用，并设置为 false。
v2
添加了以下枚举值：
枚举 值 LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
添加了以下枚举值：
枚举 值 LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
2023 年 2 月 8 日
新功能
添加了检索 YouTubeAdGroup 和 YouTubeAdGroupAd 资源以及YouTube 广告组资源定位的功能。此外，我们还添加了可在 YouTube 广告组一级使用的可检索定位类型。如需了解详情，请参阅关于检索 YouTube 及合作伙伴资源的新指南页面。
在 v1 和 v2 中新增了对四个广告交易平台的支持。
v2
添加了以下方法：
服务 方法 advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions 添加了以下字段：
服务 方法 AssignedTargetingOption YoutubeAndPartnersSettings 添加了以下枚举值：
枚举 值 广告交易平台 EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
TargetingType TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO
v1
添加了以下枚举值：
枚举 值 广告交易平台 EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
2022 年 12 月 6 日
新功能
将 v2 从公开 Beta 版移至正式版。
向 AssignedTargetingOption 资源添加了新的 assignedTargetingOptionIdAlias 字段，在检索和删除定位条件时，该字段可替代 assignedTargetingOptionId。此字段仅针对通过枚举分配的定位类型的已分配定位选项进行设置。别名值是相关枚举值（以字符串形式）。
向 Advertiser 资源添加了新的 billingConfig 字段。
添加了对检索 YouTube 及合作伙伴 OTT 订单项的支持，这些订单项由三个新的 LineItemType 值标识。
将 v1 和 v2 中的许多 list 方法的页面大小上限提高到了 200。默认页面大小保持不变。
v2
添加了以下字段：
资源 字段 广告客户 AssignedTargetingOption 添加了以下枚举值：
枚举 值 LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
以下列表方法的最大页面大小已增加：
v1
以下列表方法的最大页面大小已增加：
已知问题
此更新修复了 v2 中的以下已知问题：
- 在 v2 中使用枚举值分配的定位类型的已分配定位选项无法使用其
assignedTargetingOptionId移除或检索，而是要求用户使用枚举值。更新后，您可以使用assignedTargetingOptionId或枚举值（由AssignedTargetingOption资源中的新assignedTargetingOptionIdAlias字段标识）移除或检索这些分配的定位选项。 - 订单项
bulkUpdate请求未正确使用advertisersId请求参数，因此返回了错误。在此更新中，该方法已修复，请求参数已从advertisersId重命名为advertiserId。
2022 年 10 月 27 日
添加了在父级 InsertionOrder 中复制现有订单项的功能。
通过向 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 服务添加 create 和 delete 方法，为部分定位类型引入了部分广告订单定位写入支持。
新功能
v2
添加了以下方法：
服务 方法 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
v1
v1 未添加任何新功能。
2022 年 9 月 20 日
发布了 v2 公开 Beta 版，其中包括以下变更：
- 能够在
advertisers.lineItems和advertisers.lineItems.targetingTypes.assignedTargetingOptions服务中使用get和list方法检索 YouTube 及合作伙伴订单项及其定位设置。 advertisers.lineItems服务中新增了两种批量定位方法，可让您通过单个请求在多个订单项中修改和检索 分配的定位条件。- 新的
bulkUpdate方法，允许用户在单个请求中更新多个订单项的entityStatus。 - 新的定位逻辑，要求使用枚举值（而不是使用
targetingTypes.targetingOptions服务检索的定位选项 ID）来分配和检索部分定位类型的AssignedTargetingOption资源。
请按照迁移指南中的步骤从 v1 迁移到 v2。
在 v1 中添加了对三个新广告交易平台的支持。
新功能
v2
下面列出了 v1 和 v2 之间的变更：
v2 中添加了以下方法：
服务 方法 advertisers.lineItems bulkEditAssignedTargetingOptions
以下方法已在 v2 中移除：
服务 方法 advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
以下方法在 v2 中已重命名：
服务 旧方法名称 新方法名称 advertisers bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions 合作伙伴 bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions 以下定位类型的
AssignedTargetingOption资源在 v2 中使用枚举进行定位分配。在 v2 中，这些定位类型的AssignedTargetingOption资源的assignedTargetingOptionId字段也已更新为使用枚举值的字符串版本：定位类型 枚举类型 TARGETING_TYPE_AGE_RANGE AgeRange TARGETING_TYPE_CONTENT_INSTREAM_POSITION ContentInstreamPosition TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION ContentOutstreamPosition TARGETING_TYPE_DEVICE_TYPE DeviceType TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION ContentRatingTier TARGETING_TYPE_ENVIRONMENT 环境 TARGETING_TYPE_EXCHANGE 广告交易平台 TARGETING_TYPE_GENDER 性别 TARGETING_TYPE_HOUSEHOLD_INCOME HouseholdIncome TARGETING_TYPE_NATIVE_CONTENT_POSITION NativeContentPosition TARGETING_TYPE_OMID Omid TARGETING_TYPE_PARENTAL_STATUS ParentalStatus TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION SensitiveCategory TARGETING_TYPE_VIDEO_PLAYER_SIZE VideoPlayerSize TARGETING_TYPE_VIEWABILITY 可见度 v2 中添加了以下字段：
以下字段已从 v2 中移除：
v2 中以下字段已设为必填字段：
v2 中添加了以下枚举值：
枚举 值 AgeRange AGE_RANGE_18_20
AGE_RANGE_21_24
AGE_RANGE_25_29
AGE_RANGE_30_34
AGE_RANGE_35_39
AGE_RANGE_40_44
AGE_RANGE_45_49
AGE_RANGE_50_54
AGE_RANGE_55_59
AGE_RANGE_60_64
ContentRatingTier CONTENT_RATING_TIER_FAMILIES
广告交易平台 EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
ReservationType RESERVATION_TYPE_INSTANT_RESERVE
RESERVATION_TYPE_PETRA_VIRAL
SensitiveCategory SENSITIVE_CATEGORY_EMBEDDED_VIDEO
SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO
在 v2 中移除了以下枚举值：
枚举 值 LineItemFlightDateType LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
LineItemWarningMessage APP_INSTALL_NO_CONVERSION_PIXEL
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
NO_CREATIVE_FOR_TARGETED_DEALS
NO_POSITIVE_AUDIENCE_LIST_TARGETED
TARGETING_DEPRECATED_GEO_TARGET
TARGETING_REVOKED_OR_CLOSED_USER_LIST
v1
v1 中添加了以下枚举值：
枚举 值 广告交易平台 EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
2022 年 5 月 26 日
添加了通过新的 inventorySources 服务写入方法和新的 guaranteedOrders 服务创建 InventorySource 资源和管理 GuaranteedOrder 资源的功能。
在 CustomBiddingAlgorithm 资源中引入了 modelReadiness 字段。此字段会列出可访问该算法模型的每个广告客户的模型就绪情况。
为 advertisers.creatives.list 方法启用了新的 filter 查询参数功能，让用户只能检索给定时间戳之前或之后具有 updateTime 的广告素材。
通过添加 SdfVersion 枚举值，添加了对最新 SDF 版本 v5.5 的支持。
新功能
添加了以下方法：
服务 方法 guaranteedOrders inventorySources 添加了以下字段：
资源 字段 CustomBiddingAlgorithm InventorySource 添加了以下枚举值：
枚举 值 SdfVersion 现在，以下列表方法可按以下属性进行过滤：
方法 字段 advertisers.creatives.list
2022 年 3 月 31 日
添加了对根据内容时长、直播类型和类型检索和设置定位条件的支持。
向 InsertionOrder 对象添加了 billableOutcome 字段。
向 MaximizeSpendBidStrategy 对象引入了 raiseBidForDeals 字段，让用户可以设置出价策略是否对目标交易应用广告客户底价。
新功能
添加了以下字段：
资源 字段 AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption 添加了以下枚举值：
枚举 值 TargetingType
2022 年 2 月 2 日
添加了对创建、更新和修改特定客户匹配 FirstAndThirdPartyAudience 资源成员的支持。您可以参阅我们新版使用受众群体指南中的上传目标客户匹配受众群体页面，详细了解如何使用这些新功能。
在 InsertionOrder 和 LineItem 资源中引入了新的 reservationType 字段，用于标识资源是采用“采用代码保证”模式、采用“程序化保证”模式还是不采用任何保证模式。
添加了通过新的 excludeNewExchanges 字段检索和设置订单项是否自动定位到新的广告交易平台的功能。
除了新功能之外，默认配额限制也翻了一番。
新功能
添加了以下方法：
服务 方法 firstAndThirdPartyAudiences 添加了以下字段：
资源 字段 FirstAndThirdPartyAudience InsertionOrder LineItem
2021 年 12 月 8 日
在定位类型 TARGETING_TYPE_AUDIO_CONTENT_TYPE 下添加了对音频内容类型定位的支持。
新功能
添加了以下字段：
资源 字段 AssignedTargetingOption TargetingOption 添加了以下枚举值：
枚举 值 TargetingType
2021 年 11 月 8 日
添加了对管理自定义出价算法及其脚本的全面支持。 其中包括：
- 用于创建新
customBiddingAlgorithms和更新现有customBiddingAlgorithms的函数。 - 能够通过以下过程上传脚本：检索可用资源位置，然后将文件上传到该位置。
- 用于检索和创建
customBiddingScripts的新customBiddingAlgorithms.scripts服务。
我们在管理订单项指南中新增了实现自定义出价页面，其中介绍了创建自定义出价算法、上传脚本以及将自定义出价算法指定为订单项的出价策略的流程。
通过添加 SdfVersion 枚举值，添加了对最新 SDF 版本 v5.4 的支持。
新功能
添加了以下方法：
服务 方法 customBiddingAlgorithms customBiddingAlgorithms.scripts media 添加了以下枚举值：
枚举 值 SdfVersion
2021 年 9 月 14 日
在定位类型 TARGETING_TYPE_BUSINESS_CHAIN 和 TARGETING_TYPE_POI 下添加了对邻近区域定位的支持。
添加了使用 targetingTypes.targetingOptions.search 搜索可用 TARGETING_TYPE_BUSINESS_CHAIN 和 TARGETING_TYPE_POI 定位选项的功能，因为这些选项无法通过 targetingTypes.targetingOptions.get 或 targetingTypes.targetingOptions.list 方法检索。
向“自定义出价算法”资源引入了新的 sharedAdvertiserIds 和 customBiddingAlgorithmState 字段，并添加了对 GOAL_BUILDER_BASED 自定义出价算法类型的支持。
向 Exchange 枚举添加了两个新值。
新功能
添加了以下字段：
资源 字段 AssignedTargetingOption CustomBiddingAlgorithm TargetingOption TargetingOptions.search 请求正文 添加了以下枚举值：
枚举 值 CustomBiddingAlgorithmType 广告交易平台 TargetingType 现在，以下列表方法可按以下属性进行过滤：
方法 字段 customBiddingAlgorithms.list
2021 年 8 月 4 日
在定位类型 TARGETING_TYPE_OMID 下，新增了对启用了开放式衡量的广告资源定位的支持。
提高了使用 pageSize 方法参数的各种广告客户、广告系列、广告订单和订单项分配的定位选项列表方法在单个页面中可返回的分配的定位选项的数量上限。
新功能
添加了以下字段：
资源 字段 AssignedTargetingOption TargetingOption 添加了以下枚举值：
枚举 值 TargetingType 以下列表方法的最大页面大小已增加：
2021 年 5 月 26 日
推出了 advertisers.invoices 服务，让用户可以：
- 检索向广告客户在指定月份开具的账单。
- 查询广告客户在指定月份使用的币种代码。
向广告系列资源添加了 campaignBudgets 字段。广告订单预算细分可以与广告系列预算相关联，将关联细分的预算总和限制为广告系列预算总金额。
在新的定位类型 TARGETING_TYPE_NATIVE_CONTENT_POSITION 下添加了对原生内容位置定位的支持。
向广告客户资源引入了新的 prismaEnabled 字段，让用户能够启用与 Mediaocean 的 Prisma 工具的集成。
为广告客户的 entityStatus 字段启用了对 ENTITY_STATUS_PAUSED 枚举值的支持。
新功能
添加了以下方法：
服务 方法 advertisers.invoices 添加了以下字段：
资源 字段 广告客户 AssignedTargetingOption TargetingOption 添加了以下枚举值：
枚举 值 AssignedTargetingOption.Recency 广告交易平台 TargetingType 以下枚举值现在适用于以下字段：
资源 字段 值 广告客户 entityStatus ENTITY_STATUS_PAUSED
2021 年 4 月 29 日
向渠道和否定关键字列表资源添加了新字段，用于返回使用相应资源进行定位的行项数。为订单项列表方法启用了新的 filter 属性，让用户只能检索在定位中使用特定渠道或否定关键字列表的订单项。
新功能
添加了以下字段：
资源 字段 声道 现在，以下列表方法可按以下属性进行过滤：
方法 字段 advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
2021 年 3 月 30 日
向订单项服务添加了新方法，用于生成具有默认配置的订单项。这些默认值基于指定的订单项类型，以及父广告订单的设置和分配的定位条件。
支持通过新的广告系列定位服务和其他批量名单方法检索广告系列定位条件。
对 advertisers.channels.sites、partners.channels.sites 和 advertisers.negativeKeywordLists.negativeKeywords 服务进行了多项更改，以便更轻松地管理频道和否定关键字列表内容。这些更改包括：
- 添加了
replace方法，让用户能够完全覆盖渠道或否定关键字列表的现有内容。 - 移除了以下要求：批量修改请求的
createdSites或createdNegativeKeywords字段中不得包含任何现有项。 - 列出网站或列出否定关键字响应中单个页面上可返回的项数上限有所增加。
新功能
添加了以下方法：
添加了以下字段：
资源 字段 AssignedTargetingOption.AppAssignedTargetingOptionDetails 以下列表方法的最大页面大小已增加：
方法 旧版页面大小上限 新的最大页面大小 advertisers.channels.sites.list 100 10000 advertisers.negativeKeywordLists.negativeKeywords.list 100 1000 partners.channels.sites.list 100 10000
弃用
以下枚举值无法再分配给新资源或现有资源：
枚举 值 PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
2021 年 2 月 24 日
引入了新的广告订单定位服务和其他批量列表方法，以便检索分配给广告订单的定位条件。扩展了广告素材资源，添加了仅限输出的广告素材字段，供第三方音频广告素材使用。添加了新的效果目标类型，供广告订单和广告系列资源使用。
新功能
添加了以下方法：
服务 方法 advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 添加了以下字段：
资源 字段 广告素材 添加了以下枚举值：
枚举 值 ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
2021 年 1 月 27 日
通过引入新的 InsertionOrderType 字段和新的 LineItemType 枚举值，实现了电视广告订单和 OTT 订单项的检索和管理。添加了对通过 mobileApp 订单项字段添加的移动应用订单项的支持。通过其他枚举值扩展了对广告交易平台、Google 受众群体和 SDF 的支持。引入了按上次更新时间过滤和排序 advertisers.list 值的功能。
新功能
添加了以下字段：
资源 字段 InsertionOrder LineItem 添加了以下枚举值：
枚举 值 广告交易平台 GoogleAudienceType LineItemType SdfVersion 以下列表方法现在可以按以下字段进行排序和过滤：
方法 字段 广告客户
2020 年 12 月 4 日
添加了搜索地理区域定位选项的功能，以及按上次更新时间过滤多个资源列表方法结果的功能。引入了新的 LineItemWarningMessage，以便在订单项使用已废弃的地理位置定位时通知用户。
新功能
添加了以下方法：
服务 方法 targetingTypes.targetingOptions 添加了以下枚举值：
枚举 值 广告交易平台 LineItemWarningMessage 以下列表方法现在可以按以下字段进行排序和过滤：
方法 字段 advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
2020 年 11 月 5 日
添加了用于创建、分配和启用用于启动关联订单项支出的手动触发器的功能。引入了定位范围扩展选项，设置后，可扩大订单项的定位范围，以涵盖与目标受众群体中的用户相似的用户。向第三方验证定位中使用的 DoubleVerify 和 Integral Ad Science 对象附加了自定义细分受众群 ID 字段。
新功能
添加了以下服务：
服务 方法 advertisers.manualTriggers 添加了以下字段：
资源 字段 AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight 添加了以下枚举值：
枚举 值 LineItemFlightDateType 以下列表方法现在可按以下字段进行过滤：
方法 字段 advertisers.lineItems.list
2020 年 10 月 12 日
为订单项资源和点击率 (CTR) 效果目标类型引入了可检索的警告消息。在列出订单项时，添加了 warningMessages 作为可过滤字段。
除了新功能之外，新的配额限制现已生效，并且我们还提供了有关使用批量请求的新文档。
新功能
添加了以下字段：
资源 字段 LineItem 添加了以下枚举值：
枚举 值 PerformanceGoalType 以下列表方法现在可按以下字段进行过滤：
方法 字段 advertisers.lineItems.list
2020 年 8 月 28 日
在广告客户审核方法的响应中添加了新字段，并在各种列表方法中添加了新的可过滤字段。
新功能
添加了以下字段：
资源 字段 Advertisers.Audit Response Body 以下列表方法现在可按以下字段进行过滤：
方法 字段 advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
2020 年 8 月 4 日
推出了新的用户管理、合作伙伴和合作伙伴定位服务。推出了一些工具，帮助用户主动避免达到账号实体数量限制。添加了对音频订单项的支持，以及在订单项和广告订单出价策略中使用自定义出价算法的功能。
新功能
添加了以下服务：
服务 方法 customBiddingAlgorithms 合作伙伴 partners.targetingTypes.assignedTargetingOptions 用户 添加了以下方法：
服务 方法 广告客户 添加了以下字段：
资源 字段 MaximizeSpendBidStrategy PerformanceGoalBidStrategy 添加了以下枚举值：
枚举 值 BiddingStrategyPerformanceGoalType LineItemType 以下列表方法现在可以按以下字段进行排序和过滤：
方法 字段 advertisers.lineItems.list 添加了以下范围，供以下服务使用：
范围 服务 https://www.googleapis.com/auth/display-video-user-management
2020 年 6 月 24 日
发布了一项小更新，为合作伙伴和广告客户渠道添加了创建方法、新的 FirstAndThirdPartyAudience 字段，以及其他 exchange 枚举值。
新功能
添加了以下服务：
服务 方法 advertisers.channels partners.channels 添加了以下字段：
资源 字段 FirstAndThirdPartyAudience 添加了以下枚举值：
枚举 值 广告交易平台 以下列表方法现在可按以下字段进行过滤：
方法 字段 advertisers.creatives.list
2020 年 6 月 2 日
引入了创建、修补和填充部分可定位实体的功能，还添加了修改广告客户级定位的功能，可针对以下三种定位类型进行修改：渠道、数字内容标签排除对象和敏感类别排除对象。
新功能
添加了以下服务：
添加了以下方法：
服务 方法 广告客户 advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels 添加了以下字段：
资源 字段 广告客户 广告素材 insertionOrder.insertionOrderBudgetSegment
2020 年 4 月 27 日
推出了大量功能集，将 API 的范围扩大到了 SDF 之外。添加了核心资源管理功能，可让您创建、检索、更新和删除广告客户、广告系列、广告订单、订单项和广告素材等实体。借助新功能，您还可以在订单项级别修改定位条件。
新功能
添加了以下服务：
2020 年 3 月 9 日
发布了 Display & Video 360 API v1。这是该 API 的初始版本。
已知问题
无。