本页提供了 Display & Video 360 API 的版本说明。
最新 API 版本: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 添加了以下字段:
资源 字段 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 中添加了对结构化数据文件 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 日
新功能
在公开 Beta 版中发布了 v3,其中包括以下更改:
- 能够全面管理邻近区域位置列表,从而能够使用
advertisers.locationLists.assignedLocations
服务创建和删除已分配给TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
资源的位置。 - 一个新的布尔值
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 启用
制作游戏
停用
get
list
patch
advertisers.youtubeAdGroupAds get
list
advertisers.youtubeAdGroups bulkListAdGroupAssignedTargetingOptions
get
list
advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions get
list
以下方法行为发生了变化:
方法 更改 advertisers.locationLists.create 现在支持创建 TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
资源。advertisers.locationLists.patch 现在支持更新 TARGETING_LOCATION_TYPE_PROXIMITY
个LocationList
资源。advertisers.locationLists.assignedLocations.bulkEdit 现在支持批量修改 TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
资源中的AssignedLocation
资源。advertisers.locationLists.assignedLocations.create 现在支持在 TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
资源中创建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
字段。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 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.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 现在,可以通过以下属性过滤以下列表方法:
方法 字段 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 交换 TargetingType 以下枚举值现在适用于以下字段:
资源 字段 值 广告客户 entityStatus ENTITY_STATUS_PAUSED
2021 年 4 月 29 日
向 Channel 和 否定关键字列表资源添加了新字段,可返回使用该资源进行定位的订单项数量。为订单项列表方法启用了新的 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 日
通过引入新的 InsertOrderType 字段和新的 LineItemType 枚举值,可以检索和管理电视广告订单和 OTT 服务订单项。通过 mobileApp
订单项字段添加了对移动应用订单项的支持。通过额外的枚举值扩大了对广告交易平台、Google 受众群体和 SDF 的支持。引入了按上次更新时间对 advertisers.list
值进行过滤和排序的功能。
新功能
添加了以下字段:
资源 字段 InsertionOrder LineItem 添加了以下枚举值:
枚举 值 交换 GoogleAudienceType LineItemType SdfVersion 现在可以通过以下字段对以下 list 方法进行排序和过滤:
方法 字段 广告客户
2020 年 12 月 4 日
添加了搜索地理区域定位选项以及按上次更新时间过滤多个资源列表方法结果的功能。引入了新的 LineItemWarningMessage,以便在订单项使用已弃用的地理位置定位时通知用户。
新功能
添加了以下方法:
服务 方法 targetingTypes.targetingOptions 添加了以下枚举值:
枚举 值 交换 LineItemWarningMessage 现在可以通过以下字段对以下 list 方法进行排序和过滤:
方法 字段 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 现在,可以通过以下字段过滤以下列表方法:
方法 字段 advertisers.lineItems.list
2020 年 10 月 12 日
针对订单项资源和点击率 (CTR) 效果目标类型引入了可检索到的警告消息。添加了 warningMessages
作为列出订单项时的可过滤字段。
除了新功能之外,新的配额限制现已生效,并且我们还提供关于利用批量请求的新文档。
新功能
添加了以下字段:
资源 字段 LineItem 添加了以下枚举值:
枚举 值 PerformanceGoalType 现在,可以通过以下字段过滤以下列表方法:
方法 字段 advertisers.lineItems.list
2020 年 8 月 28 日
在广告客户审核方法的响应中添加了新字段,并为各种列表方法添加了新的可过滤字段。
新功能
添加了以下字段:
资源 字段 Advertiser.Audit 响应正文 现在,可以通过以下字段过滤以下列表方法:
方法 字段 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 现在可以通过以下字段对以下 list 方法进行排序和过滤:
方法 字段 advertisers.lineItems.list 添加了以下范围,用于以下服务:
范围 服务 https://www.googleapis.com/auth/display-video-user-management
2020 年 6 月 24 日
发布了一项小规模更新,为合作伙伴和广告客户渠道添加了 create 方法,并添加了新的 FirstAndThirdPartyAudience 字段,并增加了其他 Exchange 枚举值。
新功能
添加了以下服务:
服务 方法 advertisers.channels partners.channels 添加了以下字段:
资源 字段 FirstAndThirdPartyAudience 添加了以下枚举值:
枚举 值 交换 现在,可以通过以下字段过滤以下列表方法:
方法 字段 advertisers.creatives.list
2020 年 6 月 2 日
推出了创建、修补和填充一部分可定位实体的功能,并新增了以下 3 种定位类型的广告客户级定位条件:渠道、数字内容标签排除和敏感类别排除。
新功能
添加了以下服务:
添加了以下方法:
服务 方法 广告客户 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 的初始版本。
已知问题
无。