发行说明

本页提供了展示广告和Video 360 API。

最新 API 版本：v3

2024 年 7 月 15 日

新功能

现已支持在以下位置下载订单项和广告组结构化数据文件： v3 中的质量检查格式。

v3

• 添加了以下字段：

  资源	字段
  IdFilter	adGroupQaIds lineItemQaIds

• 添加了以下枚举值：

  枚举	值
  FileType	FILE_TYPE_AD_GROUP_QA FILE_TYPE_LINE_ITEM_QA

2024 年 6 月 17 日

新功能

新增了对管理在广告客户级分配的关键字定位的支持。

向广告订单添加了新的 optimizationObjective 字段 资源。optimizationObjective仅适用于列入许可名单的客户。

v3

• 添加了以下字段：

  资源	字段
  InsertionOrder	optimizationObjective

• 以下方法现在支持以下定位类型：

  定位类型	方法
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

v2

• 以下方法现在支持以下定位类型：

  定位类型	方法
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

2024 年 5 月 30 日

新功能

添加了对结构化数据文件 (SDF) 7.1 版的支持。

v3

• 添加了以下枚举值：

  枚举	值
  SdfVersion	SDF_VERSION_7_1

v2

• 添加了以下枚举值：

  枚举	值
  SdfVersion	SDF_VERSION_7_1

2024 年 4 月 23 日

新功能

添加了对新的 KPI 类型、广告交易平台和应用平台的支持。

v3

• 添加了以下字段：

  资源	字段
  KPI	kpiAlgorithmId

• 添加了以下枚举值：

  枚举	值
  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	removedContactInfoList removedMobileDeviceIdList

• 添加了以下枚举值：

  枚举	值
  广告交易平台	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

v2

• 添加了以下字段：

  资源	字段
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• 添加了以下枚举值：

  枚举	值
  广告交易平台	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	get list

• 添加了以下字段：

  资源	字段
  用户	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

v2

• 添加了以下方法：

  服务	方法
  floodlightGroups.floodlightActivities	get list

• 添加了以下字段：

  资源	字段
  用户	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

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	get list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	get list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	create get list

• 移除了以下方法：

  服务	方法
  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_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	advertiserId

• 以下字段是必填字段：

  资源	字段
  广告客户	billingConfig

• 添加了以下字段：

  资源	字段
  BiddingStrategy	youtubeAndPartnersBid
  InsertionOrder	kpi
  合作伙伴	billingConfig
  TargetingExpansionConfig	audienceExpansionLevel audienceExpansionSeedListExcluded enableOptimizedTargeting
  YoutubeAndPartnersSettings	thirdPartyMeasurementConfigs
  YoutubeAndPartnersInventorySourceConfig	includeYoutube

• 已移除以下字段：

  资源	字段
  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	effectiveContentCategory

• 已移除以下字段：

  资源	字段
  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	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• 添加了以下字段：

  服务	方法
  AssignedTargetingOption	sessionPositionDetails youtubeChannelDetails youtubeVideoDetails
  YoutubeAndPartnersSettings	leadFormId linkedMerchantId relatedVideoIds targetFrequency videoAdSequenceSettings

• 添加了以下枚举值：

  枚举	值
  广告交易平台	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

• 添加了以下字段：

  资源	字段
  广告客户	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

• 添加了以下枚举值：

  枚举	值
  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

• 以下列表方法增加了页面大小上限：

  方法	新的页面大小上限
  advertisers.campaigns.list	200
  advertisers.channels.list	200
  advertisers.creatives.list	200
  advertisers.invoices.list	200
  advertisers.lineItems.list	200
  advertisers.list	200
  advertisers.locationLists.assignedLocations.list	200
  advertisers.locationLists.list	200
  advertisers.manualTriggers.list	200
  advertisers.negativeKeywordLists.list	200
  combinedAudiences.list	200
  customBiddingAlgorithms.list	200
  customBiddingAlgorithms.scripts.list	200
  customLists.list	200
  firstAndThirdPartyAudiences.list	200
  googleAudiences.list	200
  guaranteedOrders.list	200
  inventorySourceGroups.list	200
  inventorySources.list	200
  partners.channels.list	200
  partners.list	200
  partners.targetingTypes.assignedTargetingOptions.list	200
  targetingTypes.targetingOptions.list	200
  targetingTypes.targetingOptions.search	200
  users.list	200

v1

• 以下列表方法增加了页面大小上限：

  方法	新的页面大小上限
  advertisers.campaigns.list	200
  advertisers.channels.list	200
  advertisers.creatives.list	200
  advertisers.invoices.list	200
  advertisers.lineItems.list	200
  advertisers.list	200
  advertisers.locationLists.assignedLocations.list	200
  advertisers.locationLists.list	200
  advertisers.manualTriggers.list	200
  advertisers.negativeKeywordLists.list	200
  combinedAudiences.list	200
  customBiddingAlgorithms.list	200
  customBiddingAlgorithms.scripts.list	200
  customLists.list	200
  firstAndThirdPartyAudiences.list	200
  googleAudiences.list	200
  guaranteedOrders.list	200
  inventorySourceGroups.list	200
  inventorySources.list	200
  partners.channels.list	200
  partners.list	200
  partners.targetingTypes.assignedTargetingOptions.list	200
  targetingTypes.targetingOptions.list	200
  targetingTypes.targetingOptions.search	200
  users.list	200

已知问题

此更新修复了 v2 中的以下已知问题：

• 使用枚举分配的定位类型的已分配定位选项 值无法移除或检索 使用其assignedTargetingOptionId，而不是预期 用户使用枚举值。本次更新后，这些已分配的定位条件 使用 assignedTargetingOptionId 或枚举值，由 新的 assignedTargetingOptionIdAlias 字段， AssignedTargetingOption 资源。
• 订单项 bulkUpdate 请求未正确使用 advertisersId 请求参数，返回错误。本次更新后 此方法已修复，并且请求参数已从 advertisersId至 advertiserId。

2022 年 10 月 27 日

添加了在父级中复制现有订单项的功能 InsertionOrder.

开始支持部分广告订单定位写入 添加了 create 和 delete 方法添加到 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 服务。

新功能

v2

• 添加了以下方法：

  服务	方法
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	create delete
  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 bulkListAssignedTargetingOptions bulkUpdate

• 以下方法在 v2 中已被移除：

  服务	方法
  advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions

• 以下方法在 v2 中已重命名：

  服务	旧方法名称	新方法名称
  advertisers	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions	editAssignedTargetingOptions listAssignedTargetingOptions
  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 中添加了以下字段：

  资源	字段
  CustomBiddingAlgorithm	modelDetails
  DeviceTypeAssignedTargetingOptionDetails	youtubeAndPartnersBidMultiplier
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  ExchangeAssignedTargetingOptionDetails	广告交易平台
  FrequencyCap	maxViews
  LineItem	youtubeAndPartnersSettings
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadius proximityRadiusUnit
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory

• v2 中移除了以下字段：

  资源	字段
  AgeRangeAssignedTargetingOptionDetails	targetingOptionId
  ContentInstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  ContentOutstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  CustomBiddingAlgorithm	customBiddingAlgorithmState
  DeviceTypeAssignedTargetingOptionDetails	targetingOptionId
  DigitalContentLabelAssignedTargetingOptionDetails	contentRatingTier excludedTargetingOptionId
  EnvironmentAssignedTargetingOptionDetails	targetingOptionId
  ExchangeAssignedTargetingOptionDetails	targetingOptionId
  GenderAssignedTargetingOptionDetails	targetingOptionId
  HouseholdIncomeAssignedTargetingOptionDetails	targetingOptionId
  LineItem	inventorySourceIds
  LineItemFlight	triggerId
  NativeContentPositionAssignedTargetingOptionDetails	targetingOptionId
  OmidAssignedTargetingOptionDetails	targetingOptionId
  ParentalStatusAssignedTargetingOptionDetails	targetingOptionId
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadiusRange
  SensitiveCategoryAssignedTargetingOptionDetails	excludedTargetingOptionId sensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	targetingOptionId
  ViewabilityAssignedTargetingOptionDetails	targetingOptionId

• 在 v2 中，以下字段是必填项：

  资源	字段
  AgeRangeAssignedTargetingOptionDetails	ageRange
  ContentInstreamPositionAssignedTargetingOptionDetails	contentInstreamPosition
  ContentOutstreamPositionAssignedTargetingOptionDetails	contentOutstreamPosition
  DeviceTypeAssignedTargetingOptionDetails	deviceType
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  EnvironmentAssignedTargetingOptionDetails	环境
  ExchangeAssignedTargetingOptionDetails	广告交易平台
  GenderAssignedTargetingOptionDetails	gender [适用性别]
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	可见度

• 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	create editGuaranteedOrderReadAccessors get list patch
  inventorySources	create editInventorySourceReadWriteAccessors patch

• 添加了以下字段：

  资源	字段
  CustomBiddingAlgorithm	modelReadiness
  InventorySource	inventorySourceProductType guaranteedOrderId readAdvertiserIds readPartnerIds readWriteAccessors

• 添加了以下枚举值：

  枚举	值
  SdfVersion	SDF_VERSION_5_5

• 现在，可以通过以下属性过滤以下列表方法：

  方法	字段
  <ph type="x-smartling-placeholder"></ph> advertisers.creatives.list	updateTime

2022 年 3 月 31 日

添加了对在以下位置检索和设置定位的支持： 内容时长、直播类型 和类型。

向 InsertionOrder 添加了 billableOutcome 字段 对象。

在raiseBidForDeals MaximizeSpendBidStrategy 对象，让用户能够设置 策略会对目标交易应用广告客户底价。

新功能

• 添加了以下字段：

  资源	字段
  AssignedTargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails
  InsertionOrder	billableOutcome
  MaximizeSpendBidStrategy	raiseBidForDeals
  TargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails

• 添加了以下枚举值：

  枚举	值
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

2022 年 2 月 2 日

添加了对创建、更新和 修改特定目标客户匹配名单的成员 FirstAndThirdPartyAudience 资源。通过 上传目标客户匹配受众群体页面，位于新版 使用受众群体指南详细介绍了如何使用这些新功能。

在reservationType InsertionOrder和LineItem 用于确定资源是否为基于代码的有保证程序化交易的资源 有保证或无保证。

增加了检索和设置订单项是否自动定位的功能 通过新的 excludeNewExchanges 创建新的广告交易平台 字段。

除了新功能外，默认配额限制已翻倍。

新功能

• 添加了以下方法：

  服务	方法
  firstAndThirdPartyAudiences	create editCustomerMatchMembers patch

• 添加了以下字段：

  资源	字段
  FirstAndThirdPartyAudience	appId contactInfoList mobileDeviceIdList
  InsertionOrder	reservationType
  LineItem	excludeNewExchanges reservationType

2021 年 12 月 8 日

在定位类型下添加了对音频内容类型定位的支持 TARGETING_TYPE_AUDIO_CONTENT_TYPE.

新功能

• 添加了以下字段：

  资源	字段
  AssignedTargetingOption	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

• 添加了以下枚举值：

  枚举	值
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

2021 年 11 月 8 日

添加了对管理自定义出价算法及其脚本的全面支持。 包括：

• 用于创建新函数和更新现有函数的函数 customBiddingAlgorithms。
• 能够 检索可用的资源位置 上传文件到该位置。
• 一项新的 customBiddingAlgorithms.scripts 服务 检索和创建 customBiddingScripts。

添加了新的实施自定义出价页面 管理订单项指南中介绍了 创建自定义出价算法、上传脚本以及 指定自定义出价算法作为订单项的出价策略。

通过v5.4 添加了 SdfVersion 枚举值。

新功能

• 添加了以下方法：

  服务	方法
  customBiddingAlgorithms	create patch uploadScript
  customBiddingAlgorithms.scripts	create get list
  media	上传

• 添加了以下枚举值：

  枚举	值
  SdfVersion	SDF_VERSION_5_4

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	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  TargetingOptions.search 请求正文	businessChainSearchTerms poiSearchTerms

• 添加了以下枚举值：

  枚举	值
  CustomBiddingAlgorithmType	GOAL_BUILDER_BASED
  广告交易平台	EXCHANGE_RED_FOR_PUBLISHERS EXCHANGE_TAPJOY
  TargetingType	TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_POI

• 现在，可以通过以下属性过滤以下列表方法：

  方法	字段
  <ph type="x-smartling-placeholder"></ph> customBiddingAlgorithms.list	customBiddingAlgorithmState

2021 年 8 月 4 日

添加了对已启用 Open Measurement 的支持 广告资源定位条件 TARGETING_TYPE_OMID。

增加了可返回的已分配定位选项的数量上限 各个广告客户、广告系列、 为广告订单和订单项分配的定位条件 使用 pageSize 方法参数的 option 列出方法。

新功能

• 添加了以下字段：

  资源	字段
  AssignedTargetingOption	omidDetails
  TargetingOption	omidDetails

• 添加了以下枚举值：

  枚举	值
  TargetingType	TARGETING_TYPE_OMID

• 以下列表方法增加了页面大小上限：

  方法	新的页面大小上限
  advertisers.campaigns.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.lineItems.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.targetingTypes.assignedTargetingOptions.list	5000

2021 年 5 月 26 日

发布了 advertisers.invoices 服务， 用户：

• 检索在给定月份内发送给广告商的发票。
• 查询广告客户在指定月份使用的货币代码。

为广告系列添加了 campaignBudgets 字段 资源。广告订单预算期可关联到 广告系列预算，限制广告系列的总预算 广告系列预算总额。

添加了对 原生内容位置定位（位于 定位类型TARGETING_TYPE_NATIVE_CONTENT_POSITION。

为广告客户引入了新的 prismaEnabled 字段 资源，让用户能够启用与 Mediaocean 的 Prisma 工具集成。

支持将 ENTITY_STATUS_PAUSED 枚举值设为 广告客户的 entityStatus 字段。

新功能

• 添加了以下方法：

  服务	方法
  advertisers.invoices	list lookupInvoiceCurrency

• 添加了以下字段：

  资源	字段
  广告客户	prismaEnabled
  AssignedTargetingOption	nativeContentPositionDetails
  广告系列	campaignBudgets
  TargetingOption	nativeContentPositionDetails

• 添加了以下枚举值：

  枚举	值
  <ph type="x-smartling-placeholder"></ph> AssignedTargetingOption.Recency	<ph type="x-smartling-placeholder"></ph> RECENCY_45_DAYS
  <ph type="x-smartling-placeholder"></ph> 广告交易平台	<ph type="x-smartling-placeholder"></ph> EXCHANGE_MEDIANET
  <ph type="x-smartling-placeholder"></ph> TargetingType	<ph type="x-smartling-placeholder"></ph> TARGETING_TYPE_NATIVE_CONTENT_POSITION

• 以下枚举值现在适用于以下字段：

  资源	字段	值
  广告客户	entityStatus	ENTITY_STATUS_PAUSED

2021 年 4 月 29 日

向频道和 返回行数的否定关键字列表资源 个项目使用该资源进行定位。已启用新版filter 订单项列表方法的属性，允许用户 仅检索使用特定渠道或否定关键字的订单项 列表。

新功能

• 添加了以下字段：

  资源	字段
  Channel	negativelyTargetedLineItemCount positivelyTargetedLineItemCount
  NegativeKeywordList	targetedLineItemCount

• 现在，可以通过以下属性过滤以下列表方法：

  方法	字段
  <ph type="x-smartling-placeholder"></ph> advertisers.lineItems.list	targetedChannelId targetedNegativeKeywordListId

2021 年 3 月 30 日

向订单项服务添加了新方法，该方法可生成 默认配置的订单项这些默认值是基于 指定的订单项类型以及广告系列的设置和分配的 父级广告订单的定位条件。

可让用户通过 新的广告系列定位服务和 其他批量列表方法。

扩展了应用定位范围，以便能够定位应用 在更多平台上推出

对advertisers.channels.sites进行了多项更改， partners.channels.sites和 advertisers.negativeKeywordLists.negativeKeywords 项服务提供给 可以更轻松地管理频道和否定关键字列表内容。这些 更改包括：

• 添加了 replace 方法，让用户能够完全覆盖 渠道或否定关键字列表的现有内容。
• 取消了 createdSites中包含的商品，或 批量修改的 createdNegativeKeywords 个字段 请求。
• 增加单个商品可退货的数量上限 列出网站中的页面，或 list 否定关键字响应。

新功能

• 添加了以下方法：

  服务	方法
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	get list
  advertisers.channels.sites	replace
  advertisers.lineItems	generateDefault
  advertisers.negativeKeywordLists.negativeKeywords	replace
  partners.channels.sites	replace

• 添加了以下字段：

  资源	字段
  AssignedTargetingOption.AppAssignedTargetingOptionDetails	appPlatform

• 以下列表方法增加了页面大小上限：

  方法	旧的页面大小上限	新的页面大小上限
  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 日

推出了新的广告订单定位服务并 其他批量列表方法，可让您检索 定位条件分配给广告订单。扩展了广告素材资源，添加了 仅限输出的广告素材字段 第三方音频广告素材新增了新的效果目标类型 供广告订单和广告系列使用 资源。

新功能

• 添加了以下方法：

  服务	方法
  <ph type="x-smartling-placeholder"></ph> advertisers.insertionOrders	<ph type="x-smartling-placeholder"></ph> bulkListInsertionOrderAssignedTargetingOptions
  <ph type="x-smartling-placeholder"></ph> advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	<ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表

• 添加了以下字段：

  资源	字段
  <ph type="x-smartling-placeholder"></ph> 广告素材	<ph type="x-smartling-placeholder"></ph> mp3Audio <ph type="x-smartling-placeholder"></ph> oggAudio

• 添加了以下枚举值：

  枚举	值
  <ph type="x-smartling-placeholder"></ph> ContentInstreamPosition	<ph type="x-smartling-placeholder"></ph> CONTENT_INSTREAM_POSITION_UNKNOWN
  <ph type="x-smartling-placeholder"></ph> PerformanceGoalType	<ph type="x-smartling-placeholder"></ph> PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE <ph type="x-smartling-placeholder"></ph> PERFORMANCE_GOAL_TYPE_CLICK_CVR <ph type="x-smartling-placeholder"></ph> PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR <ph type="x-smartling-placeholder"></ph> PERFORMANCE_GOAL_TYPE_VCPM <ph type="x-smartling-placeholder"></ph> PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE <ph type="x-smartling-placeholder"></ph> PERFORMANCE_GOAL_TYPE_VTR

2021 年 1 月 27 日

支持检索和管理电视广告订单及 OTT 服务订单项 介绍 新建 InsertOrderType 字段和 新的 LineItemType 枚举值。添加了对移动应用的支持 通过 mobileApp 订单项字段指定订单项。 扩展的广告交易平台、Google 受众群体和 通过其他枚举值支持 SDF。推出了 可对 advertisers.list 进行过滤和排序 值。

新功能

• 添加了以下字段：

  资源	字段
  <ph type="x-smartling-placeholder"></ph> InsertionOrder	<ph type="x-smartling-placeholder"></ph> insertionOrderType
  <ph type="x-smartling-placeholder"></ph> LineItem	<ph type="x-smartling-placeholder"></ph> mobileApp

• 添加了以下枚举值：

  枚举	值
  <ph type="x-smartling-placeholder"></ph> 广告交易平台	<ph type="x-smartling-placeholder"></ph> EXCHANGE_SHARETHROUGH <ph type="x-smartling-placeholder"></ph> EXCHANGE_SOUNDCAST
  <ph type="x-smartling-placeholder"></ph> GoogleAudienceType	<ph type="x-smartling-placeholder"></ph> GOOGLE_AUDIENCE_TYPE_EXTENDED_DEMOGRAPHIC <ph type="x-smartling-placeholder"></ph> GOOGLE_AUDIENCE_TYPE_LIFE_EVENT
  <ph type="x-smartling-placeholder"></ph> LineItemType	<ph type="x-smartling-placeholder"></ph> LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP
  <ph type="x-smartling-placeholder"></ph> SdfVersion	<ph type="x-smartling-placeholder"></ph> SDF_VERSION_5_3

• 现在可以通过以下字段对以下 list 方法进行排序和过滤：

  方法	字段
  <ph type="x-smartling-placeholder"></ph> 广告主	<ph type="x-smartling-placeholder"></ph> updateTime

2020 年 12 月 4 日

添加了搜索 地理区域定位选项和过滤多个资源 list 方法结果按上次更新时间排序。引入了 new LineItemWarningMessage 告知用户 订单项使用的是已弃用的地理位置定位。

新功能

• 添加了以下方法：

  服务	方法
  <ph type="x-smartling-placeholder"></ph> targetingTypes.targetingOptions	<ph type="x-smartling-placeholder"></ph> 搜索

• 添加了以下枚举值：

  枚举	值
  <ph type="x-smartling-placeholder"></ph> 广告交易平台	<ph type="x-smartling-placeholder"></ph> EXCHANGE_SUPERSHIP
  <ph type="x-smartling-placeholder"></ph> LineItemWarningMessage	<ph type="x-smartling-placeholder"></ph> TARGETING_DEPRECATED_GEO_TARGET

• 现在可以通过以下字段对以下 list 方法进行排序和过滤：

  方法	字段
  <ph type="x-smartling-placeholder"></ph> advertisers.campaigns.list	<ph type="x-smartling-placeholder"></ph> updateTime
  <ph type="x-smartling-placeholder"></ph> advertisers.insertionOrders.list	<ph type="x-smartling-placeholder"></ph> updateTime
  <ph type="x-smartling-placeholder"></ph> advertisers.lineItems.list	<ph type="x-smartling-placeholder"></ph> updateTime

2020 年 11 月 5 日

增加了创建、分配和激活的功能 启动关联订单项的手动触发器 支出。推出了定位范围扩展选项，以便： 设置后，您可以扩大订单项的定位范围，以包含与以下类似的用户： 。已将自定义细分 ID 字段附加到 DoubleVerify 和 Integral Ad Science 对象 第三方验证定位条件。

新功能

• 添加了以下服务：

  服务	方法
  <ph type="x-smartling-placeholder"></ph> advertisers.manualTriggers	<ph type="x-smartling-placeholder"></ph> 启用 <ph type="x-smartling-placeholder"></ph> 制作 <ph type="x-smartling-placeholder"></ph> 停用 <ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表 <ph type="x-smartling-placeholder"></ph> 补丁

• 添加了以下字段：

  资源	字段
  <ph type="x-smartling-placeholder"></ph> AssignedTargetingOption.DoubleVerify	<ph type="x-smartling-placeholder"></ph> customSegmentId
  <ph type="x-smartling-placeholder"></ph> AssignedTargetingOption.IntegralAdScience	<ph type="x-smartling-placeholder"></ph> customSegmentId
  <ph type="x-smartling-placeholder"></ph> LineItem	<ph type="x-smartling-placeholder"></ph> targetingExpansion
  <ph type="x-smartling-placeholder"></ph> LineItemFlight	<ph type="x-smartling-placeholder"></ph> triggerId

• 添加了以下枚举值：

  枚举	值
  <ph type="x-smartling-placeholder"></ph> LineItemFlightDateType	<ph type="x-smartling-placeholder"></ph> LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

• 现在，可以通过以下字段过滤以下列表方法：

  方法	字段
  <ph type="x-smartling-placeholder"></ph> advertisers.lineItems.list	<ph type="x-smartling-placeholder"></ph> filter.triggerId

2020 年 10 月 12 日

向订单项引入了可检索的警告消息 资源和点击率 (CTR) 效果目标类型。已添加 warningMessages 作为可过滤字段。

除了新功能之外，新的配额限制现已生效， 提供了有关使用批处理请求的新文档。

新功能

• 添加了以下字段：

  资源	字段
  <ph type="x-smartling-placeholder"></ph> LineItem	<ph type="x-smartling-placeholder"></ph> warningMessages

• 添加了以下枚举值：

  枚举	值
  <ph type="x-smartling-placeholder"></ph> PerformanceGoalType	<ph type="x-smartling-placeholder"></ph> PERFORMANCE_GOAL_TYPE_CTR

• 现在，可以通过以下字段过滤以下列表方法：

  方法	字段
  <ph type="x-smartling-placeholder"></ph> advertisers.lineItems.list	<ph type="x-smartling-placeholder"></ph> warningMessages

2020 年 8 月 28 日

在广告客户审核方法和 为各种列表方法添加了新的可过滤字段。

新功能

• 添加了以下字段：

  资源	字段
  <ph type="x-smartling-placeholder"></ph> Advertisers.Audit 响应正文	<ph type="x-smartling-placeholder"></ph> adGroupCriteriaCount <ph type="x-smartling-placeholder"></ph> campaignCriteriaCount <ph type="x-smartling-placeholder"></ph> channelsCount <ph type="x-smartling-placeholder"></ph> negativeKeywordListsCount <ph type="x-smartling-placeholder"></ph> negativelyTargetedChannelsCount

• 现在，可以通过以下字段过滤以下列表方法：

  方法	字段
  <ph type="x-smartling-placeholder"></ph> advertisers.list	<ph type="x-smartling-placeholder"></ph> advertiserId <ph type="x-smartling-placeholder"></ph> displayName
  <ph type="x-smartling-placeholder"></ph> advertisers.campaigns.list	<ph type="x-smartling-placeholder"></ph> campaignId <ph type="x-smartling-placeholder"></ph> displayName
  <ph type="x-smartling-placeholder"></ph> advertisers.insertionOrders.list	<ph type="x-smartling-placeholder"></ph> budget.budget_segments.date_range.end_date <ph type="x-smartling-placeholder"></ph> displayName
  <ph type="x-smartling-placeholder"></ph> advertisers.lineItems.list	<ph type="x-smartling-placeholder"></ph> displayName <ph type="x-smartling-placeholder"></ph> lineItemId
  <ph type="x-smartling-placeholder"></ph> targetingTypes.targetingOptions.list	<ph type="x-smartling-placeholder"></ph> carrierAndIspDetails.type <ph type="x-smartling-placeholder"></ph> geoRegionDetails.geo_region_type

2020 年 8 月 4 日

推出了新的用户管理、合作伙伴和合作伙伴定位服务。推出了各种工具，帮助用户主动避免达到账号实体数量上限。添加了对音频订单项的支持，以及在订单项和广告订单出价策略中使用自定义出价算法的功能。

新功能

• 添加了以下服务：

  服务	方法
  <ph type="x-smartling-placeholder"></ph> customBiddingAlgorithms	<ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表
  <ph type="x-smartling-placeholder"></ph> 合作伙伴	<ph type="x-smartling-placeholder"></ph> bulkEditPartnerAssignedTargetingOptions <ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表
  <ph type="x-smartling-placeholder"></ph> partners.targetingTypes.assignedTargetingOptions	<ph type="x-smartling-placeholder"></ph> 制作 <ph type="x-smartling-placeholder"></ph> 删除 <ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表
  <ph type="x-smartling-placeholder"></ph> 位用户	<ph type="x-smartling-placeholder"></ph> bulkEditAssignedUserRoles <ph type="x-smartling-placeholder"></ph> 制作 <ph type="x-smartling-placeholder"></ph> 删除 <ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表 <ph type="x-smartling-placeholder"></ph> 补丁

• 添加了以下方法：

  服务	方法
  <ph type="x-smartling-placeholder"></ph> 广告主	<ph type="x-smartling-placeholder"></ph> 审核

• 添加了以下字段：

  资源	字段
  <ph type="x-smartling-placeholder"></ph> MaximizeSpendBidStrategy	<ph type="x-smartling-placeholder"></ph> customBiddingAlgorithmId
  <ph type="x-smartling-placeholder"></ph> PerformanceGoalBidStrategy	<ph type="x-smartling-placeholder"></ph> customBiddingAlgorithmId

• 添加了以下枚举值：

  枚举	值
  <ph type="x-smartling-placeholder"></ph> BiddingStrategyPerformanceGoalType	<ph type="x-smartling-placeholder"></ph> BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  <ph type="x-smartling-placeholder"></ph> LineItemType	<ph type="x-smartling-placeholder"></ph> LINE_ITEM_TYPE_AUDIO_DEFAULT

• 现在可以通过以下字段对以下 list 方法进行排序和过滤：

  方法	字段
  <ph type="x-smartling-placeholder"></ph> advertisers.lineItems.list	<ph type="x-smartling-placeholder"></ph> flight.dateRange.endDate

• 添加了以下范围，用于以下服务：

  范围	服务
  https://www.googleapis.com/auth/display-video-user-management	<ph type="x-smartling-placeholder"></ph> 位用户

2020 年 6 月 24 日

发布了一项小规模更新，为合作伙伴和广告客户渠道添加了 create 方法，并添加了新的 FirstAndThirdPartyAudience 字段，并增加了其他 Exchange 枚举值。

新功能

• 添加了以下服务：

  服务	方法
  <ph type="x-smartling-placeholder"></ph> advertisers.channels	<ph type="x-smartling-placeholder"></ph> 制作
  <ph type="x-smartling-placeholder"></ph> partners.channels	<ph type="x-smartling-placeholder"></ph> 制作

• 添加了以下字段：

  资源

  字段

  <ph type="x-smartling-placeholder"></ph> FirstAndThirdPartyAudience

  <ph type="x-smartling-placeholder"></ph> activeDisplayAudienceSize <ph type="x-smartling-placeholder"></ph> audienceSource <ph type="x-smartling-placeholder"></ph> audienceType <ph type="x-smartling-placeholder"></ph> 说明 <ph type="x-smartling-placeholder"></ph> displayAudienceSize <ph type="x-smartling-placeholder"></ph> displayDesktopAudienceSize <ph type="x-smartling-placeholder"></ph> displayMobileAppAudienceSize <ph type="x-smartling-placeholder"></ph> displayMobileWebAudienceSize <ph type="x-smartling-placeholder"></ph> gmailAudienceSize <ph type="x-smartling-placeholder"></ph> membershipDurationDays <ph type="x-smartling-placeholder"></ph> youtubeAudienceSize

• 添加了以下枚举值：

  枚举	值
  <ph type="x-smartling-placeholder"></ph> 广告交易平台	<ph type="x-smartling-placeholder"></ph> EXCHANGE_OPEN8 <ph type="x-smartling-placeholder"></ph> EXCHANGE_TRITON <ph type="x-smartling-placeholder"></ph> EXCHANGE_UNRULYX

• 现在，可以通过以下字段过滤以下列表方法：

  方法	字段
  <ph type="x-smartling-placeholder"></ph> advertisers.creatives.list	<ph type="x-smartling-placeholder"></ph> creativeId

2020 年 6 月 2 日

推出了创建、修补和填充一部分可定位实体的功能，并新增了以下 3 种定位类型的广告客户级定位条件：渠道、数字内容标签排除和敏感类别排除。

新功能

• 添加了以下服务：

  服务	方法
  <ph type="x-smartling-placeholder"></ph> advertisers.channels.sites	<ph type="x-smartling-placeholder"></ph> bulkEdit <ph type="x-smartling-placeholder"></ph> 制作 <ph type="x-smartling-placeholder"></ph> 删除 <ph type="x-smartling-placeholder"></ph> 列表
  <ph type="x-smartling-placeholder"></ph> advertisers.locationLists.assignedLocations	<ph type="x-smartling-placeholder"></ph> bulkEdit <ph type="x-smartling-placeholder"></ph> 制作 <ph type="x-smartling-placeholder"></ph> 删除 <ph type="x-smartling-placeholder"></ph> 列表
  <ph type="x-smartling-placeholder"></ph> advertisers.negativeKeywordLists.negativeKeywords	<ph type="x-smartling-placeholder"></ph> bulkEdit <ph type="x-smartling-placeholder"></ph> 制作 <ph type="x-smartling-placeholder"></ph> 删除 <ph type="x-smartling-placeholder"></ph> 列表
  <ph type="x-smartling-placeholder"></ph> advertisers.targetingTypes.assignedTargetingOptions	<ph type="x-smartling-placeholder"></ph> 制作 <ph type="x-smartling-placeholder"></ph> 删除 <ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表
  <ph type="x-smartling-placeholder"></ph> inventorySourceGroups.assignedInventorySources	<ph type="x-smartling-placeholder"></ph> bulkEdit <ph type="x-smartling-placeholder"></ph> 制作 <ph type="x-smartling-placeholder"></ph> 删除 <ph type="x-smartling-placeholder"></ph> 列表
  <ph type="x-smartling-placeholder"></ph> partners.channels.sites	<ph type="x-smartling-placeholder"></ph> bulkEdit <ph type="x-smartling-placeholder"></ph> 制作 <ph type="x-smartling-placeholder"></ph> 删除 <ph type="x-smartling-placeholder"></ph> 列表

• 添加了以下方法：

  服务	方法
  <ph type="x-smartling-placeholder"></ph> 广告主	<ph type="x-smartling-placeholder"></ph> bulkEditAdvertiserAssignedTargetingOptions <ph type="x-smartling-placeholder"></ph> bulkListAdvertiserAssignedTargetingOptions
  <ph type="x-smartling-placeholder"></ph> advertisers.channels	<ph type="x-smartling-placeholder"></ph> 补丁
  <ph type="x-smartling-placeholder"></ph> advertisers.locationLists	<ph type="x-smartling-placeholder"></ph> 制作 <ph type="x-smartling-placeholder"></ph> 补丁
  <ph type="x-smartling-placeholder"></ph> advertisers.negativeKeywordLists	<ph type="x-smartling-placeholder"></ph> 制作 <ph type="x-smartling-placeholder"></ph> 删除 <ph type="x-smartling-placeholder"></ph> 补丁
  <ph type="x-smartling-placeholder"></ph> inventorySourceGroups	<ph type="x-smartling-placeholder"></ph> 制作 <ph type="x-smartling-placeholder"></ph> 删除 <ph type="x-smartling-placeholder"></ph> 补丁
  <ph type="x-smartling-placeholder"></ph> partners.channels	<ph type="x-smartling-placeholder"></ph> 补丁

• 添加了以下字段：

  资源	字段
  <ph type="x-smartling-placeholder"></ph> 广告主	<ph type="x-smartling-placeholder"></ph> servingConfig
  <ph type="x-smartling-placeholder"></ph> 有创意	<ph type="x-smartling-placeholder"></ph> lineItemIds
  <ph type="x-smartling-placeholder"></ph> insertionOrder.insertionOrderBudgetSegment	<ph type="x-smartling-placeholder"></ph> campaignBudgetId

2020 年 4 月 27 日

发布了大型功能集，将 API 的范围延伸到了 SDF 之外。已添加 核心资源管理，可用于创建、检索、更新和删除实体，例如广告客户、广告系列、广告订单、订单项 广告素材。通过这些新功能，您还可以在订单项级别修改定位条件。

新功能

添加了以下服务：

服务	方法
<ph type="x-smartling-placeholder"></ph> 广告主	<ph type="x-smartling-placeholder"></ph> 制作 <ph type="x-smartling-placeholder"></ph> 删除 <ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表 <ph type="x-smartling-placeholder"></ph> 补丁
<ph type="x-smartling-placeholder"></ph> advertisers.assets	<ph type="x-smartling-placeholder"></ph> 上传
<ph type="x-smartling-placeholder"></ph> advertisers.campaigns	<ph type="x-smartling-placeholder"></ph> 制作 <ph type="x-smartling-placeholder"></ph> 删除 <ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表 <ph type="x-smartling-placeholder"></ph> 补丁
<ph type="x-smartling-placeholder"></ph> advertisers.channels	<ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表
<ph type="x-smartling-placeholder"></ph> advertisers.creatives	<ph type="x-smartling-placeholder"></ph> 制作 <ph type="x-smartling-placeholder"></ph> 删除 <ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表 <ph type="x-smartling-placeholder"></ph> 补丁
<ph type="x-smartling-placeholder"></ph> advertisers.insertionOrders	<ph type="x-smartling-placeholder"></ph> 制作 <ph type="x-smartling-placeholder"></ph> 删除 <ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表 <ph type="x-smartling-placeholder"></ph> 补丁
<ph type="x-smartling-placeholder"></ph> advertisers.lineItems	<ph type="x-smartling-placeholder"></ph> bulkEditLineItemAssignedTargetingOptions <ph type="x-smartling-placeholder"></ph> bulkListLineItemAssignedTargetingOptions <ph type="x-smartling-placeholder"></ph> 制作 <ph type="x-smartling-placeholder"></ph> 删除 <ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表 <ph type="x-smartling-placeholder"></ph> 补丁
<ph type="x-smartling-placeholder"></ph> advertisers.lineItems.targetingTypes.assignedTargetingOptions	<ph type="x-smartling-placeholder"></ph> 制作 <ph type="x-smartling-placeholder"></ph> 删除 <ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表
<ph type="x-smartling-placeholder"></ph> advertisers.locationLists	<ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表
<ph type="x-smartling-placeholder"></ph> advertisers.negativeKeywordLists	<ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表
<ph type="x-smartling-placeholder"></ph> combinedAudiences	<ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表
<ph type="x-smartling-placeholder"></ph> customLists	<ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表
<ph type="x-smartling-placeholder"></ph> firstAndThirdPartyAudiences	<ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表
<ph type="x-smartling-placeholder"></ph> floodlightGroups	<ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 补丁
<ph type="x-smartling-placeholder"></ph> googleAudiences	<ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表
<ph type="x-smartling-placeholder"></ph> inventorySourceGroups	<ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表
<ph type="x-smartling-placeholder"></ph> inventorySources	<ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表
<ph type="x-smartling-placeholder"></ph> partners.channels	<ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表
<ph type="x-smartling-placeholder"></ph> partners.channels	<ph type="x-smartling-placeholder"></ph> 获取 <ph type="x-smartling-placeholder"></ph> 列表

2020 年 3 月 9 日

投放展示广告和Video 360 API v1。这是此 API 的初始版本。

已知问题

无。