本页提供了展示广告和Video 360 API。
最新 API 版本：v3
2024 年 8 月 15 日
新功能
添加了对 Netflix Exchange 类型的支持。
v3
添加了以下枚举值：
枚举 值 广告交易平台 EXCHANGE_NETFLIX
v2
添加了以下枚举值：
枚举 值 广告交易平台 EXCHANGE_NETFLIX
2024 年 7 月 15 日
新功能
现已支持在以下位置下载订单项和广告组结构化数据文件： v3 中的质量检查格式。
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 服务。
添加了一个新字段，用于指明 YouTube 和合作伙伴订单项 将 Google TV 广告资源纳入到了定位条件中。
添加了一个新字段，用于中继显示和视频 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 枚举值，以更准确地表示
体现相关格式
通过添加
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字段， 替换了targetingExpansionLevel字段TargetingExpansionConfig对象。 - 第
billingConfig字段（Advertiser资源：advertisers.create请求，以及新的Partner中的billingConfig字段 资源。 - 新的
AdGroup和AdGroupAd资源 替换 v2 中的YoutubeAdGroup和YoutubeAdGroupAd资源。
按照迁移指南中的步骤，从 v2 迁移到 v3。
添加了对 3 个新 LineItemType 值的支持，1 个新值
YoutubeAndPartnersBiddingStrategyType，以及 1 项新的
v2 和 v3 中为 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_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 日
新功能
为结构化数据文件添加了新的 SdfVersion 值
(SDF) v6。
v2
添加了以下枚举值：
枚举 值 SdfVersion SDF_VERSION_6
v1
添加了以下枚举值：
枚举 值 SdfVersion SDF_VERSION_6
2023 年 3 月 9 日
新功能
添加了新的 LineItemWarningMessage 值，该值将
已分配给订单项的 warningMessages 字段
已弃用的 excludeFirstPartyAudience 字段设为
true。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 中新增了对 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 版转为正式版。
向assignedTargetingOptionIdAlias
AssignedTargetingOption 资源，可用于代替
assignedTargetingOptionId。
只能为符合以下条件的定位类型的已分配定位选项设置此字段：
通过枚举进行分配。别名值是字符串形式的相关枚举值。
向billingConfig
Advertiser 资源。
增加了对检索 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 中的以下已知问题：
- 使用枚举分配的定位类型的已分配定位选项
值无法移除或检索
使用其
assignedTargetingOptionId，而不是预期 用户使用枚举值。本次更新后，这些已分配的定位条件 使用assignedTargetingOptionId或枚举值，由 新的assignedTargetingOptionIdAlias字段，AssignedTargetingOption资源。 - 订单项
bulkUpdate请求未正确使用advertisersId请求参数，返回错误。本次更新后 此方法已修复，并且请求参数已从advertisersId至advertiserId。
2022 年 10 月 27 日
添加了在父级中复制现有订单项的功能
InsertionOrder。
开始支持部分广告订单定位写入
添加了 create 和
delete 方法添加到
advertisers.insertionOrders.targetingTypes.assignedTargetingOptions
服务。
新功能
v2
添加了以下方法：
服务 方法 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
v1
v1 中未添加任何新功能。
2022 年 9 月 20 日
在公开 Beta 版中发布了 v2，其中包括以下更改：
- 能够检索 YouTube 和合作伙伴订单项及其定位
在
advertisers.lineItems中使用get和list方法进行设置 和advertisers.lineItems.targetingTypes.assignedTargetingOptions服务。 advertisers.lineItems服务中新增了两种批量定位方式 修改和检索 为多个订单项分配了定位条件，同时 单一请求。- 新增了
bulkUpdate方法，可让用户更新entityStatus。 - 需要
AssignedTargetingOption的新定位逻辑 部分定位类型中的资源， 使用枚举值（而不是定位选项 ID）进行分配和检索 使用targetingTypes.targetingOptions服务检索的数据。
按照迁移指南中的步骤，从 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 在 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 日
添加了创建 InventorySource 资源和
用于管理GuaranteedOrder资源
inventorySources 服务写入方法和新增的
guaranteedOrders 服务。
在modelReadiness
CustomBiddingAlgorithm 资源。此字段会列出
算法模型。
为以下各项启用了新的 filter 查询参数功能：
advertisers.creatives.list 方法，
，以便仅检索具有 updateTime 属性的广告素材
在指定时间戳之前或之后。
通过v5.5
添加了 SdfVersion 枚举值。
新功能
添加了以下方法：
服务 方法 guaranteedOrders inventorySources 添加了以下字段：
资源 字段 CustomBiddingAlgorithm InventorySource 添加了以下枚举值：
枚举 值 SdfVersion 现在，可以通过以下属性过滤以下列表方法：
方法 字段 advertisers.creatives.list
2022 年 3 月 31 日
添加了对在以下位置检索和设置定位的支持： 内容时长、直播类型 和类型。
向 InsertionOrder 添加了 billableOutcome 字段
对象。
在 raiseBidForDeals
MaximizeSpendBidStrategy 对象，让用户能够设置
策略会对目标交易应用广告客户底价。
新功能
添加了以下字段：
资源 字段 AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption 添加了以下枚举值：
枚举 值 TargetingType
2022 年 2 月 2 日
添加了对创建、更新和
修改特定目标客户匹配名单的成员
FirstAndThirdPartyAudience 资源。通过
上传目标客户匹配受众群体页面，位于新版
使用受众群体指南详细介绍了如何使用这些新功能。
在reservationType
InsertionOrder和LineItem
用于确定资源是否为基于代码的有保证程序化交易的资源
有保证或无保证。
增加了检索和设置订单项是否自动定位的功能
通过新的 excludeNewExchanges 创建新的广告交易平台
字段。
除了新功能外，默认配额限制已翻倍。
新功能
添加了以下方法：
服务 方法 firstAndThirdPartyAudiences 添加了以下字段：
资源 字段 FirstAndThirdPartyAudience InsertionOrder LineItem
2021 年 12 月 8 日
在定位类型下添加了对音频内容类型定位的支持
TARGETING_TYPE_AUDIO_CONTENT_TYPE。
新功能
添加了以下字段：
资源 字段 AssignedTargetingOption TargetingOption 添加了以下枚举值：
枚举 值 TargetingType
2021 年 11 月 8 日
添加了对管理自定义出价算法及其脚本的全面支持。 其中包括：
- 用于创建新函数和更新现有函数的函数
customBiddingAlgorithms。 - 能够 检索可用的资源位置 上传文件到该位置。
- 一项新的
customBiddingAlgorithms.scripts服务 检索和创建customBiddingScripts。
添加了新的实施自定义出价页面 管理订单项指南中介绍了 创建自定义出价算法、上传脚本以及 指定自定义出价算法作为订单项的出价策略。
通过v5.4
添加了 SdfVersion 枚举值。
新功能
添加了以下方法：
服务 方法 customBiddingAlgorithms customBiddingAlgorithms.scripts media 添加了以下枚举值：
枚举 值 SdfVersion
2021 年 9 月 14 日
在定位类型下添加了对邻近区域定位的支持
TARGETING_TYPE_BUSINESS_CHAIN和
TARGETING_TYPE_POI。
增加了搜索可用资源的功能
TARGETING_TYPE_BUSINESS_CHAIN和
TARGETING_TYPE_POI个定位选项，
targetingTypes.targetingOptions.search，因为它们不能
通过 targetingTypes.targetingOptions.get 检索到，或者
targetingTypes.targetingOptions.list 方法。
推出了新的 sharedAdvertiserIds 和
customBiddingAlgorithmState 字段添加到自定义出价
算法资源，并添加了对
GOAL_BUILDER_BASED 自定义出价算法类型。
向 Exchange 枚举添加了两个新值。
新功能
添加了以下字段：
资源 字段 AssignedTargetingOption CustomBiddingAlgorithm TargetingOption TargetingOptions.search 请求正文 添加了以下枚举值：
枚举 值 CustomBiddingAlgorithmType 广告交易平台 TargetingType 现在，可以通过以下属性过滤以下列表方法：
方法 字段 customBiddingAlgorithms.list
2021 年 8 月 4 日
添加了对已启用 Open Measurement 的支持
广告资源定位条件
TARGETING_TYPE_OMID。
增加了可返回的已分配定位选项的数量上限
各个广告客户、广告系列、
为广告订单和订单项分配的定位条件
使用 pageSize 方法参数的 option 列出方法。
新功能
添加了以下字段：
资源 字段 AssignedTargetingOption TargetingOption 添加了以下枚举值：
枚举 值 TargetingType 以下列表方法增加了页面大小上限：
2021 年 5 月 26 日
发布了 advertisers.invoices 服务，
用户：
- 检索在给定月份内发送给广告商的发票。
- 查询广告客户在指定月份使用的货币代码。
为广告系列添加了 campaignBudgets 字段
资源。广告订单预算期可关联到
广告系列预算，限制广告系列的总预算
广告系列预算总额。
添加了对
原生内容位置定位（位于
定位类型TARGETING_TYPE_NATIVE_CONTENT_POSITION。
为广告客户引入了新的 prismaEnabled 字段
资源，让用户能够启用与 Mediaocean 的 Prisma 工具集成。
支持将 ENTITY_STATUS_PAUSED 枚举值设为
广告客户的 entityStatus 字段。
新功能
添加了以下方法：
服务 方法 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个字段 请求。 - 增加单个商品可退货的数量上限 列出网站中的页面，或 list 否定关键字响应。
新功能
添加了以下方法：
添加了以下字段：
资源 字段 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 日
支持检索和管理电视广告订单及 OTT 服务订单项
介绍
新建 InsertOrderType 字段和
新的 LineItemType 枚举值。添加了对移动应用的支持
通过 mobileApp 订单项字段指定订单项。
扩展的广告交易平台、Google 受众群体和
通过其他枚举值支持 SDF。推出了
可对 advertisers.list 进行过滤和排序
值。
新功能
添加了以下字段：
资源 字段 InsertionOrder LineItem 添加了以下枚举值：
枚举 值 广告交易平台 GoogleAudienceType LineItemType SdfVersion 现在可以通过以下字段对以下 list 方法进行排序和过滤：
方法 字段 广告主
2020 年 12 月 4 日
添加了搜索 地理区域定位选项和过滤多个资源 list 方法结果按上次更新时间排序。引入了 new 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 日
在广告客户审核方法和 为各种列表方法添加了新的可过滤字段。
新功能
添加了以下字段：
资源 字段 Advertisers.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 日
投放展示广告和Video 360 API v1。这是此 API 的初始版本。
已知问题
无。