本页提供了 Display & Video 360 API 的版本说明。
最新 API 版本：v3
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 添加了以下字段：
资源 字段 User YoutubeAndPartnersInventorySourceConfig
v2
添加了以下方法：
服务 方法 floodlightGroups.floodlightActivities 添加了以下字段：
资源 字段 User YoutubeAndPartnersInventorySourceConfig
2023 年 11 月 14 日
新功能
现已支持在所有当前版本中上传目标客户匹配受众群体成员时传递最终用户的同意声明。
v3
添加了以下字段：
资源 字段 ContactInfoList MobileDeviceIdList
v2
添加了以下字段：
资源 字段 ContactInfoList MobileDeviceIdList
2023 年 10 月 31 日
新功能
v3 已从公开 Beta 版中移出，变为正式版。
在 v3 中对 AdGroupFormat 枚举值进行了重命名，以便更准确地反映相关格式。
通过在 v2 和 v3 中添加 SDF_VERSION_7 枚举值，添加了对结构化数据文件 v7 的支持。
v3
移除了以下枚举值：
枚举 值 AdGroupFormat AD_GROUP_FORMAT_ACTION
添加了以下枚举值：
枚举 值 AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
添加了以下枚举值：
枚举 值 SdfVersion SDF_VERSION_7
2023 年 10 月 2 日
新功能
在公开 Beta 版中发布了 v3，其中包括以下变更：
- 能够全面管理邻近区域位置列表，从而能够使用
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 值、一个新 YoutubeAndPartnersBiddingStrategyType 和一个新 PartnerCostType 的支持。
v3
添加了以下方法：
服务 方法 advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules 移除了以下方法：
服务 方法 advertisers.manualTriggers 启用
制作游戏
停用
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_PROXIMITY个LocationList资源。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 值，如果订单项的 warningMessages 字段已设置为 true（已弃用的 excludeFirstPartyAudience 字段），则系统会将该值分配给该字段。2023 年 3 月 25 日之后，excludeFirstPartyAudience 字段将被弃用，并设置为 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 中新增了对 4 个额外广告交易平台的支持。
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 日
在公开 Beta 版中发布了 v2，其中包括以下变更：
- 能够在
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 partners bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions 在 v2 中，以下定位类型的
AssignedTargetingOption资源使用枚举进行定位分配。这些定位类型的AssignedTargetingOption资源的assignedTargetingOptionId字段在 v2 中也已更新，以使用枚举值的字符串版本：定位类型 枚举类型 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 奥米德 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 现在，您可以按以下属性过滤以下 list 方法：
方法 字段 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.scripts服务，用于检索和创建customBiddingScripts。
我们的管理订单项指南中新增了实现自定义出价页面，该指南介绍了创建自定义出价算法、上传脚本以及将自定义出价算法指定为订单项的出价策略的流程。
通过添加 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 现在，您可以按以下属性过滤以下 list 方法：
方法 字段 customBiddingAlgorithms.list
2021 年 8 月 4 日
在定位类型 TARGETING_TYPE_OMID 下添加了对已启用 Open Measurement 的广告资源定位的支持。
使用 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 Exchange TargetingType 以下枚举值现在对以下字段有效：
资源 Field 值 广告客户 entityStatus ENTITY_STATUS_PAUSED
2021 年 4 月 29 日
向渠道和否定关键字列表资源添加了新字段，以返回使用该资源进行定位的订单项的数量。为订单项列表方法启用了新的 filter 属性，以允许用户仅检索其定位条件中使用特定渠道或否定关键字列表的订单项。
新功能
添加了以下字段：
资源 字段 声道 现在，您可以按以下属性过滤以下 list 方法：
方法 字段 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 日
通过引入新的广告订单类型字段和新的 LineItemType 枚举值，支持对电视广告订单和 OTT 服务订单项进行检索和管理。通过 mobileApp 订单项字段添加了对移动应用订单项的支持。通过额外的枚举值扩展了广告交易平台、Google 受众群体和 SDF 支持。引入了按上次更新时间对 advertisers.list 值进行过滤和排序的功能。
新功能
添加了以下字段：
资源 字段 InsertionOrder LineItem 添加了以下枚举值：
枚举 值 Exchange GoogleAudienceType LineItemType SdfVersion 现在，您可以按以下字段对以下列表方法进行排序和过滤：
方法 字段 广告主
2020 年 12 月 4 日
新增了搜索地理区域定位选项以及按上次更新时间过滤多个资源列表方法结果的功能。引入了新的 LineItemWarningMessage，可在订单项使用已弃用的地理位置定位时通知用户。
新功能
添加了以下方法：
服务 方法 targetingTypes.targetingOptions 添加了以下枚举值：
枚举 值 Exchange LineItemWarningMessage 现在，您可以按以下字段对以下列表方法进行排序和过滤：
方法 字段 advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
2020 年 11 月 5 日
新增了创建、分配和启用手动触发器的功能，这些触发器可启动相关订单项的支出。引入了定位范围扩展选项，这些选项一经设置，即可扩展订单项的定位条件，以包含与目标受众群体中的用户类似的用户。将自定义细分 ID 字段附加到了第三方验证定位中使用的 DoubleVerify 和 Integral Ad Science 对象。
新功能
添加了以下服务：
服务 方法 advertisers.manualTriggers 添加了以下字段：
资源 字段 AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight 添加了以下枚举值：
枚举 值 LineItemFlightDateType 现在，您可以按以下字段过滤以下 list 方法：
方法 字段 advertisers.lineItems.list
2020 年 10 月 12 日
为订单项资源引入了可检索的警告消息，并添加了点击率 (CTR) 效果目标类型。添加了 warningMessages 作为列出订单项时的可过滤字段。
除了新功能之外，新的配额限制现已生效，并提供了有关使用批量请求的新文档。
新功能
添加了以下字段：
资源 字段 LineItem 添加了以下枚举值：
枚举 值 PerformanceGoalType 现在，您可以按以下字段过滤以下 list 方法：
方法 字段 advertisers.lineItems.list
2020 年 8 月 28 日
在广告主审核方法的响应中添加了新字段，并为各种列表方法添加了新的可过滤字段。
新功能
添加了以下字段：
资源 字段 Advertiser.Audit 响应正文 现在，您可以按以下字段过滤以下 list 方法：
方法 字段 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 日
发布了一项小的更新，添加了适用于合作伙伴和广告客户渠道的 create 方法、新的 FirstAndThirdPartyAudience 字段以及其他广告交易平台枚举值。
新功能
添加了以下服务：
服务 方法 advertisers.channels partners.channels 添加了以下字段：
资源 字段 FirstAndThirdPartyAudience 添加了以下枚举值：
枚举 值 Exchange 现在，您可以按以下字段过滤以下 list 方法：
方法 字段 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 的初始版本。
已知问题
无。