Release Notes

This page provides release notes for the Display & Video 360 API.

Latest API version: v3

October 22, 2024

New Features

Added support for the cost-per-view performance goal.

Added ability to set and retrieve targeting of connected devices.

Added new Adloox brand safety settings under third-party verifier targeting.

Added support for downloading v8 Structured Data Files, which is currently in closed beta.

v3

• The following fields have been added:

  Object

  Field(s)

  Adloox

  adultExplicitSexualContent armsAmmunitionContent crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent deathInjuryMilitaryConflictContent debatedSensitiveSocialIssueContent displayIabViewability excludedFraudIvtMfaCategories hateSpeechActsAggressionContent illegalDrugsTobaccoEcigarettesVapingAlcoholContent misinformationContent obscenityProfanityContent onlinePiracyContent spamHarmfulContent terrorismContent videoIabViewability

• The following enum values have been added:

  Enum	Value(s)
  DeviceType	DEVICE_TYPE_CONNECTED_DEVICE
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CPV
  SdfVersion	SDF_VERSION_8

Deprecated values

Removed support for SDF v5.5 given its sunset on October 3, 2024.

v3

• The following enum values have been deprecated:

  Enum	Value(s)
  SdfVersion	SDF_VERSION_5_5

August 15, 2024

New Features

Added support for Netflix Exchange type.

v3

• The following enum values have been added:

  Enum	Value(s)
  Exchange	EXCHANGE_NETFLIX

v2

• The following enum values have been added:

  Enum	Value(s)
  Exchange	EXCHANGE_NETFLIX

July 15, 2024

New Features

Added support for downloading Line Item and Ad Group Structured Data Files in QA format in v3.

v3

• The following fields have been added:

  Resource	Field(s)
  IdFilter	adGroupQaIds lineItemQaIds

• The following enum values have been added:

  Enum	Value(s)
  FileType	FILE_TYPE_AD_GROUP_QA FILE_TYPE_LINE_ITEM_QA

June 17, 2024

New Features

Added support for managing keyword targeting assigned at the advertiser level.

Added new optimizationObjective field to the insertion order resource. optimizationObjective is only available to allowlisted customers.

v3

• The following fields have been added:

  Resource	Field(s)
  InsertionOrder	optimizationObjective

• The following methods now support the following targeting types:

  Targeting Type	Method(s)
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

v2

• The following methods now support the following targeting types:

  Targeting Type	Method(s)
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

May 30, 2024

New Features

Added support for Structured Data Files (SDF) version 7.1.

v3

• The following enum values have been added:

  Enum	Value(s)
  SdfVersion	SDF_VERSION_7_1

v2

• The following enum values have been added:

  Enum	Value(s)
  SdfVersion	SDF_VERSION_7_1

April 23, 2024

New Features

Added support for new KPI types, exchanges, and app platforms.

v3

• The following fields have been added:

  Resource	Field(s)
  Kpi	kpiAlgorithmId

• The following enum values have been added:

  Enum	Value(s)
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Exchange	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

• The following enum values have been added:

  Enum	Value(s)
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Exchange	EXCHANGE_DRAX
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

February 28, 2024

New Features

Added the ability to explicitly remove members from customer match audiences.

Added support for targeting new exchanges.

v3

• The following fields have been added:

  Resource	Field(s)
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• The following enum values have been added:

  Enum	Value(s)
  Exchange	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

v2

• The following fields have been added:

  Resource	Field(s)
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• The following enum values have been added:

  Enum	Value(s)
  Exchange	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

January 29, 2024

New Features

Added the ability to retrieve Floodlight activities through a new floodlightGroups.floodlightActivities service.

Added a new field communicating whether a YouTube & Partners line item includes Google TV inventory in its targeting.

Added a new field to relay the last login time for a Display & Video 360 user.

v3

• The following methods have been added:

  Service	Method(s)
  floodlightGroups.floodlightActivities	get list

• The following fields have been added:

  Resource	Field(s)
  User	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

v2

• The following methods have been added:

  Service	Method(s)
  floodlightGroups.floodlightActivities	get list

• The following fields have been added:

  Resource	Field(s)
  User	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

November 14, 2023

New Features

Added support for passing end-user consent when uploading Customer Match audience members in all live versions.

v3

• The following fields have been added:

  Resource	Field(s)
  ContactInfoList	consent
  MobileDeviceIdList	consent

v2

• The following fields have been added:

  Resource	Field(s)
  ContactInfoList	consent
  MobileDeviceIdList	consent

October 31, 2023

New Features

Moved v3 out of public beta and into general availability.

Renamed an AdGroupFormat enum value in v3 to more accurately reflect the relevant format.

Added support for Structured Data Files v7 with the addition of the SDF_VERSION_7 enum value in v2 and v3.

v3

• The following enum values have been removed:

  Enum	Value(s)
  AdGroupFormat	AD_GROUP_FORMAT_ACTION

• The following enum values have been added:

  Enum	Value(s)
  AdGroupFormat	AD_GROUP_FORMAT_RESPONSIVE
  SdfVersion	SDF_VERSION_7

v2

• The following enum values have been added:

  Enum	Value(s)
  SdfVersion	SDF_VERSION_7

October 2, 2023

New Features

Released v3 in public beta, which includes the following changes:

• The ability to fully manage proximity location lists, enabling the use of the advertisers.locationLists.assignedLocations service to create and delete locations assigned to TARGETING_LOCATION_TYPE_PROXIMITY LocationList resources.
• A new boolean enableOptimizedTargeting field, which replaces the targetingExpansionLevel field in the TargetingExpansionConfig object.
• The requirement of the billingConfig field in the Advertiser resource, which must be included when making advertisers.create requests, and a new billingConfig field in the Partner resource.
• New AdGroup and AdGroupAd resources that replace the YoutubeAdGroup and YoutubeAdGroupAd resources in v2.

Follow the steps in our migration guide to migrate from v2 to v3.

Added support for 3 new LineItemType values, one new YoutubeAndPartnersBiddingStrategyType, and one new PartnerCostType in v2 and v3.

v3

• The following methods have been added:

  Service	Method(s)
  advertisers.adGroupAds	get list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	get list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	create get list

• The following methods have been removed:

  Service	Method(s)
  advertisers.manualTriggers	activate create deactivate get list patch
  advertisers.youtubeAdGroupAds	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• The following method behavior has changed:

  Method	Change(s)
  advertisers.locationLists.create	Now supports creating TARGETING_LOCATION_TYPE_PROXIMITY LocationList resources.
  advertisers.locationLists.patch	Now supports updating TARGETING_LOCATION_TYPE_PROXIMITY LocationList resources.
  advertisers.locationLists.assignedLocations.bulkEdit	Now supports bulk editing the AssignedLocation resources in TARGETING_LOCATION_TYPE_PROXIMITY LocationList resources.
  advertisers.locationLists.assignedLocations.create	Now supports creating AssignedLocation resources in TARGETING_LOCATION_TYPE_PROXIMITY LocationList resources.

• The following query parameters have been added:

  Method	Parameter(s)
  inventorySources.get	advertiserId

• The following fields have been made required:

  Resource	Field(s)
  Advertiser	billingConfig

• The following fields have been added:

  Resource	Field(s)
  BiddingStrategy	youtubeAndPartnersBid
  InsertionOrder	kpi
  Partner	billingConfig
  TargetingExpansionConfig	audienceExpansionLevel audienceExpansionSeedListExcluded enableOptimizedTargeting
  YoutubeAndPartnersSettings	thirdPartyMeasurementConfigs
  YoutubeAndPartnersInventorySourceConfig	includeYoutube

• The following fields have been removed:

  Resource	Field(s)
  InsertionOrder	performanceGoal billableOutcome
  TargetingExpansionConfig	excludeFirstPartyAudience targetingExpansionLevel
  YoutubeAndPartnersSettings	biddingStrategy thirdPartyMeasurementSettings
  YoutubeAndPartnersInventorySourceConfig	includeYoutubeSearch includeYoutubeVideos

• The following enum values have been added:

  Enum	Value(s)
  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

• The following enum values have been removed:

  Enum	Value(s)
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v2

• The following enum values have been added:

  Enum	Value(s)
  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

August 25, 2023

New Features

Added support for two exchanges and two new YouTube & Partners bidding strategy types.

Added a new effectiveContentCategory field to YouTube & Partners line items to surface the YoutubeAndPartnersContentCategory used by the line item when considering values assigned at both the advertiser and line item level.

v2

• The following fields have been added:

  Resource	Field(s)
  YoutubeAndPartnersSettings	effectiveContentCategory

• The following fields have been removed:

  Resource	Field(s)
  InventorySource	subSitePropertyId

• The following enum values have been added:

  Enum	Value(s)
  Exchange	EXCHANGE_HIVESTACK EXCHANGE_RESET_DIGITAL
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

June 5, 2023

New Features

Added a new SdfVersion value for Structured Data Files (SDF) v6 in v1 and v2.

v2

• The following enum values have been added:

  Enum	Value(s)
  SdfVersion	SDF_VERSION_6

v1

• The following enum values have been added:

  Enum	Value(s)
  SdfVersion	SDF_VERSION_6

March 9, 2023

New Features

Added a new LineItemWarningMessage value that will be assigned to a line item's warningMessages field if it has the deprecated excludeFirstPartyAudience field set to true. The excludeFirstPartyAudience field will be sunset and set to false after March 25, 2023.

v2

• The following enum values have been added:

  Enum	Value(s)
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

• The following enum values have been added:

  Enum	Value(s)
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

February 8, 2023

New Features

Added the ability to retrieve YouTubeAdGroup and YouTubeAdGroupAd resources, as well as YouTube Ad Group resource targeting. In addition, we've also added new retrievable targeting types used on the YouTube Ad Groups level. Read our new guide page on retrieving YouTube & Partners resources for more information.

Added support for four additional exchanges in v1 and v2.

v2

• The following methods have been added:

  Service	Method(s)
  advertisers.youtubeAdGroupAds	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• The following fields have been added:

  Service	Method(s)
  AssignedTargetingOption	sessionPositionDetails youtubeChannelDetails youtubeVideoDetails
  YoutubeAndPartnersSettings	leadFormId linkedMerchantId relatedVideoIds targetFrequency videoAdSequenceSettings

• The following enum values have been added:

  Enum	Value(s)
  Exchange	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

• The following enum values have been added:

  Enum	Value(s)
  Exchange	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE

December 6, 2022

New Features

Moved v2 out of public beta and into general availability.

Added a new assignedTargetingOptionIdAlias field to the AssignedTargetingOption resource, which can be used in place of the assignedTargetingOptionId when retrieving and deleting targeting. This field is only set for assigned targeting options of targeting types that are assigned via enum. The alias value is the relevant enum value as a string.

Added a new billingConfig field to the Advertiser resource.

Added support for retrieving YouTube & Partners over-the-top line items, identified by three new LineItemType values.

Increased the max page size to 200 for numerous list methods in v1 and v2. The default page size is unchanged.

v2

• The following fields have been added:

  Resource	Field(s)
  Advertiser	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

• The following enum values have been added:

  Enum	Value(s)
  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

• The max page size has been increased for the following list methods:

  Method	New Max Page Size
  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

• The max page size has been increased for the following list methods:

  Method	New Max Page Size
  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

Known issues

This update fixes the following known issues in v2:

• Assigned targeting options of targeting types that are assigned using enum values in v2 were not able to be removed or retrieved using their assignedTargetingOptionId and instead expected users to use the enum value. With this update, these assigned targeting options can be removed or retrieved using either the assignedTargetingOptionId or the enum value, identified by the new assignedTargetingOptionIdAlias field in the AssignedTargetingOption resource.
• The line item bulkUpdate request was not correctly using the advertisersId request parameter, returning an error. With this update, the method has been fixed and the request parameter has been renamed from the advertisersId to advertiserId.

October 27, 2022

Added the ability to duplicate an existing line item within the parent InsertionOrder.

Introduced partial insertion order targeting write support for a subset of targeting types with the addition of create and delete methods to the advertisers.insertionOrders.targetingTypes.assignedTargetingOptions service.

New Features

v2

• The following methods have been added:

  Service	Method(s)
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	create delete
  advertisers.lineItems	duplicate

v1

No new features have been added to v1.

September 20, 2022

Released v2 in public beta, which includes the following changes:

• The ability to retrieve YouTube & Partners line items and their targeting settings using get and list methods in the advertisers.lineItems and advertisers.lineItems.targetingTypes.assignedTargetingOptions services.
• Two new bulk targeting methods in the advertisers.lineItems service that enable editing and retrieving assigned targeting across multiple line items with a single request.
• A new bulkUpdate method that allows users to update the entityStatus of multiple line items in a single request.
• New targeting logic that requires AssignedTargetingOption resources of a subset of targeting types to be assigned and retrieved using enum values instead of targeting option IDs retrieved using the targetingTypes.targetingOptions service.

Follow the steps in our migration guide to migrate from v1 to v2.

Added support for three new exchanges in v1.

New Features

v2

The following is a list of changes between v1 and v2:

• The following methods have been added in v2:

  Service	Method(s)
  advertisers.lineItems	bulkEditAssignedTargetingOptions bulkListAssignedTargetingOptions bulkUpdate

• The following methods have been removed in v2:

  Service	Method(s)
  advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions

• The following methods have been renamed in v2:

  Service	Old Method Name	New Method Name
  advertisers	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions	editAssignedTargetingOptions listAssignedTargetingOptions
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions	listAssignedTargetingOptions
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions	listAssignedTargetingOptions
  partners	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

• AssignedTargetingOption resources of the following targeting types use enums for targeting assignment in v2. The assignedTargetingOptionId field for AssignedTargetingOption resources of these targeting types have also been updated in v2 to use string versions of the enum values:

  Targeting Type	Enum Type
  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	Environment
  TARGETING_TYPE_EXCHANGE	Exchange
  TARGETING_TYPE_GENDER	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	Viewability

• The following fields have been added in v2:

  Resource	Field(s)
  CustomBiddingAlgorithm	modelDetails
  DeviceTypeAssignedTargetingOptionDetails	youtubeAndPartnersBidMultiplier
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  ExchangeAssignedTargetingOptionDetails	exchange
  FrequencyCap	maxViews
  LineItem	youtubeAndPartnersSettings
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadius proximityRadiusUnit
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory

• The following fields have been removed in v2:

  Resource	Field(s)
  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

• The following fields have been made required in v2:

  Resource	Field(s)
  AgeRangeAssignedTargetingOptionDetails	ageRange
  ContentInstreamPositionAssignedTargetingOptionDetails	contentInstreamPosition
  ContentOutstreamPositionAssignedTargetingOptionDetails	contentOutstreamPosition
  DeviceTypeAssignedTargetingOptionDetails	deviceType
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  EnvironmentAssignedTargetingOptionDetails	environment
  ExchangeAssignedTargetingOptionDetails	exchange
  GenderAssignedTargetingOptionDetails	gender
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	viewability

• The following enum values have been added in v2:

  Enum	Value(s)
  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	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

• The following enum values have been removed in v2:

  Enum	Value(s)
  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

• The following enum values have been added in v1:

  Enum	Value(s)
  Exchange	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

May 26, 2022

Added the ability to create InventorySource resources and manage GuaranteedOrder resources through new inventorySources service write methods and a new guaranteedOrders service.

Introduced the modelReadiness field in the CustomBiddingAlgorithm resource. This field lists the readiness of the algorithm's model for each advertiser that can access it.

Enabled new filter query parameter functionality for the advertisers.creatives.list method that allows the user to only retrieve creatives with an updateTime before or after a given timestamp.

Added support for the newest SDF version, v5.5, through the addition of an SdfVersion enum value.

New Features

• The following methods have been added:

  Service	Method(s)
  guaranteedOrders	create editGuaranteedOrderReadAccessors get list patch
  inventorySources	create editInventorySourceReadWriteAccessors patch

• The following fields have been added:

  Resource	Field(s)
  CustomBiddingAlgorithm	modelReadiness
  InventorySource	inventorySourceProductType guaranteedOrderId readAdvertiserIds readPartnerIds readWriteAccessors

• The following enum values have been added:

  Enum	Value(s)
  SdfVersion	SDF_VERSION_5_5

• The following list methods are now filterable by the following properties:

  Method	Field(s)
  advertisers.creatives.list	updateTime

March 31, 2022

Added support for retrieving and setting targeting on content duration, stream type, and genre.

Added the billableOutcome field to the InsertionOrder object.

Introduced the raiseBidForDeals field to the MaximizeSpendBidStrategy object, letting users set whether the bidding strategy applies advertiser floor prices for targeted deals.

New Features

• The following fields have been added:

  Resource	Field(s)
  AssignedTargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails
  InsertionOrder	billableOutcome
  MaximizeSpendBidStrategy	raiseBidForDeals
  TargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails

• The following enum values have been added:

  Enum	Value(s)
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

February 2, 2022

Added support for creating, updating, and editing members of certain Customer Match FirstAndThirdPartyAudience resources. The Upload Customer Match Audiences page in our new Use Audiences guide details how to use these new features.

Introduced a new reservationType field in InsertionOrder and LineItem resources that identifies whether a resource is Tag Guaranteed, Programmatic Guaranteed, or not guaranteed.

Added the ability to retrieve and set whether a line item automatically targets new exchanges through a new excludeNewExchanges field.

In addition to new features, default quota limits have been doubled.

New Features

• The following methods have been added:

  Service	Method(s)
  firstAndThirdPartyAudiences	create editCustomerMatchMembers patch

• The following fields have been added:

  Resource	Field(s)
  FirstAndThirdPartyAudience	appId contactInfoList mobileDeviceIdList
  InsertionOrder	reservationType
  LineItem	excludeNewExchanges reservationType

December 8, 2021

Added support for audio content type targeting under the targeting type TARGETING_TYPE_AUDIO_CONTENT_TYPE.

New Features

• The following fields have been added:

  Resource	Field(s)
  AssignedTargetingOption	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

• The following enum values have been added:

  Enum	Value(s)
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

November 8, 2021

Added full support for managing custom bidding algorithms and their scripts. This includes:

• Functions to create new and update existing customBiddingAlgorithms.
• The ability to upload scripts through the process of retrieving an available resource location and then uploading the file to that location.
• A new customBiddingAlgorithms.scripts service to retrieve and create customBiddingScripts.

A new Implement Custom Bidding page has been added to our Managing Line Items guide that describes the process of creating a custom bidding algorithm, uploading a script, and assigning the custom bidding algorithm to be as a line item's bidding strategy.

Added support for the newest SDF version, v5.4, through the addition of an SdfVersion enum value.

New Features

• The following methods have been added:

  Service	Method(s)
  customBiddingAlgorithms	create patch uploadScript
  customBiddingAlgorithms.scripts	create get list
  media	upload

• The following enum values have been added:

  Enum	Value(s)
  SdfVersion	SDF_VERSION_5_4

September 14, 2021

Added support for proximity targeting under targeting types TARGETING_TYPE_BUSINESS_CHAIN and TARGETING_TYPE_POI.

Added the ability to search for available TARGETING_TYPE_BUSINESS_CHAIN and TARGETING_TYPE_POI targeting options using targetingTypes.targetingOptions.search, as they cannot be retrieved via targetingTypes.targetingOptions.get or targetingTypes.targetingOptions.list methods.

Introduced new sharedAdvertiserIds and customBiddingAlgorithmState fields to the Custom Bidding Algorithm resource and added support for the GOAL_BUILDER_BASED custom bidding algorithm type.

Added a two new values to the Exchange enum.

New Features

• The following fields have been added:

  Resource	Field(s)
  AssignedTargetingOption	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  TargetingOptions.search Request Body	businessChainSearchTerms poiSearchTerms

• The following enum values have been added:

  Enum	Value(s)
  CustomBiddingAlgorithmType	GOAL_BUILDER_BASED
  Exchange	EXCHANGE_RED_FOR_PUBLISHERS EXCHANGE_TAPJOY
  TargetingType	TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_POI

• The following list methods are now filterable by the following properties:

  Method	Field(s)
  customBiddingAlgorithms.list	customBiddingAlgorithmState

August 4, 2021

Added support for Open Measurement enabled inventory targeting under the targeting type TARGETING_TYPE_OMID.

Increased the maximum number of assigned targeting options that can be returned in a single page of various advertiser, campaign, insertion order, and line item assigned targeting option list methods using the pageSize method parameter.

New Features

• The following fields have been added:

  Resource	Field(s)
  AssignedTargetingOption	omidDetails
  TargetingOption	omidDetails

• The following enum values have been added:

  Enum	Value(s)
  TargetingType	TARGETING_TYPE_OMID

• The max page size has been increased for the following list methods:

  Method	New Max Page Size
  advertisers.campaigns.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.lineItems.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.targetingTypes.assignedTargetingOptions.list	5000

May 26, 2021

Launched the advertisers.invoices service, which lets users:

• retrieve invoices issued to an advertiser during a given month.
• lookup the currency code used by an advertiser during a given month.

Added the campaignBudgets field to the campaign resource. Insertion order budget segments can be linked to a campaign budget, restricting the sum budget of the associated segments to the total campaign budget amount.

Added support for native content position targeting under the new targeting type TARGETING_TYPE_NATIVE_CONTENT_POSITION.

Introduced a new prismaEnabled field to the advertiser resource, letting users enable integration with Mediaocean's Prisma tool.

Enabled support for the ENTITY_STATUS_PAUSED enum value to the Advertiser's entityStatus field.

New Features

• The following methods have been added:

  Service	Method(s)
  advertisers.invoices	list lookupInvoiceCurrency

• The following fields have been added:

  Resource	Field(s)
  Advertiser	prismaEnabled
  AssignedTargetingOption	nativeContentPositionDetails
  Campaign	campaignBudgets
  TargetingOption	nativeContentPositionDetails

• The following enum values have been added:

  Enum	Value(s)
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  Exchange	EXCHANGE_MEDIANET
  TargetingType	TARGETING_TYPE_NATIVE_CONTENT_POSITION

• The following enum values are now valid for the following fields:

  Resource	Field	Value(s)
  Advertiser	entityStatus	ENTITY_STATUS_PAUSED

April 29, 2021

Added new fields to Channel and Negative Keyword List resources that return the count of line items using the resource for targeting. Enabled new filter properties for the line item list method that allow the user to only retrieve line items that are using specific channels or negative keyword lists in their targeting.

New Features

• The following fields have been added:

  Resource	Field(s)
  Channel	negativelyTargetedLineItemCount positivelyTargetedLineItemCount
  NegativeKeywordList	targetedLineItemCount

• The following list methods are now filterable by the following properties:

  Method	Field(s)
  advertisers.lineItems.list	targetedChannelId targetedNegativeKeywordListId

March 30, 2021

Added a new method to the line item service that generates a line item with default configurations. These default values are based on the given line item type, as well as the settings and assigned targeting of the parent insertion order.

Enabled the retrieval of campaign targeting through a new campaign targeting service and additional bulk list method.

Expanded app targeting to allow the targeting of apps on more platforms.

Made multiple changes to advertisers.channels.sites, partners.channels.sites and advertisers.negativeKeywordLists.negativeKeywords services to allow for easier management of channel and negative keyword list content. These changes include:

• The addition of replace methods, which enables a user to fully overwrite the existing contents of a channel or negative keyword list.
• The removal of the requirement that no existing items be included in the createdSites or createdNegativeKeywords fields of bulk edit requests.
• The increase of the maximum number of items that can be returned on a single page of a list sites or list negative keywords response.

New Features

• The following methods have been added:

  Service	Method(s)
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	get list
  advertisers.channels.sites	replace
  advertisers.lineItems	generateDefault
  advertisers.negativeKeywordLists.negativeKeywords	replace
  partners.channels.sites	replace

• The following fields have been added:

  Resource	Field(s)
  AssignedTargetingOption.AppAssignedTargetingOptionDetails	appPlatform

• The max page size has been increased for the following list methods:

  Method	Old Max Page Size	New Max Page Size
  advertisers.channels.sites.list	100	10000
  advertisers.negativeKeywordLists.negativeKeywords.list	100	1000
  partners.channels.sites.list	100	10000

Deprecations

• The following enum values can no longer be assigned to new or existing resources:

  Enum	Value(s)
  PartnerRevenueModelMarkupType	PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

February 24, 2021

Introduced a new insertion order targeting service and additional bulk list method enabling the retrieval of targeting assigned to insertion orders. Expanded the creative resource, adding output-only creative fields for use by third-party audio creatives. Added new performance goal types for use by insertion order and campaign resources.

New Features

• The following methods have been added:

  Service	Method(s)
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	get list

• The following fields have been added:

  Resource	Field(s)
  Creative	mp3Audio oggAudio

• The following enum values have been added:

  Enum	Value(s)
  ContentInstreamPosition	CONTENT_INSTREAM_POSITION_UNKNOWN
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE PERFORMANCE_GOAL_TYPE_CLICK_CVR PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR PERFORMANCE_GOAL_TYPE_VCPM PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE PERFORMANCE_GOAL_TYPE_VTR

January 27, 2021

Enabled retrieval and management of TV insertion orders and over-the-top line items through the introduction of a new InsertionOrderType field and a new LineItemType enum value. Added support for mobile app line items through a mobileApp line item field. Expanded exchange, google audience, and SDF support through additional enum values. Introduced the capability to filter and order advertisers.list values by the last updated time.

New Features

• The following fields have been added:

  Resource	Field(s)
  InsertionOrder	insertionOrderType
  LineItem	mobileApp

• The following enum values have been added:

  Enum	Value(s)
  Exchange	EXCHANGE_SHARETHROUGH EXCHANGE_SOUNDCAST
  GoogleAudienceType	GOOGLE_AUDIENCE_TYPE_EXTENDED_DEMOGRAPHIC GOOGLE_AUDIENCE_TYPE_LIFE_EVENT
  LineItemType	LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP
  SdfVersion	SDF_VERSION_5_3

• The following list methods are now able to be ordered and filtered by the following fields:

  Method	Field(s)
  advertisers	updateTime

December 4, 2020

Added the capability to search for Geo Region targeting options and filter multiple resource list method results by their last updated time. Introduced a new LineItemWarningMessage to inform users of when a line item is using deprecated geographic targeting.

New Features

• The following methods have been added:

  Service	Method(s)
  targetingTypes.targetingOptions	search

• The following enum values have been added:

  Enum	Value(s)
  Exchange	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

• The following list methods are now able to be ordered and filtered by the following fields:

  Method	Field(s)
  advertisers.campaigns.list	updateTime
  advertisers.insertionOrders.list	updateTime
  advertisers.lineItems.list	updateTime

November 5, 2020

Added the capability to create, assign and activate manual triggers that initiate associated line items' spending. Introduced targeting expansion options that, when set, can expand the targeting of a line item to include users similar to those in targeted audiences. Appended custom segment ID fields to DoubleVerify and Integral Ad Science objects used in third-party verification targeting.

New Features

• The following services have been added:

  Service	Method(s)
  advertisers.manualTriggers	activate create deactivate get list patch

• The following fields have been added:

  Resource	Field(s)
  AssignedTargetingOption.DoubleVerify	customSegmentId
  AssignedTargetingOption.IntegralAdScience	customSegmentId
  LineItem	targetingExpansion
  LineItemFlight	triggerId

• The following enum values have been added:

  Enum	Value(s)
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

• The following list methods are now filterable by the following fields:

  Method	Field(s)
  advertisers.lineItems.list	filter.triggerId

October 12, 2020

Introduced retrievable warning messages to the line item resource and a click-through rate (CTR) performance goal type. Added warningMessages as a filterable field when listing line items.

In addition to new features, new quota limits are now in effect and new documentation on utilizing batch requests is available.

New Features

• The following fields have been added:

  Resource	Field(s)
  LineItem	warningMessages

• The following enum values have been added:

  Enum	Value(s)
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

• The following list methods are now filterable by the following fields:

  Method	Field(s)
  advertisers.lineItems.list	warningMessages

August 28, 2020

Added new fields to the response of the advertiser audit method and new filterable fields to various list methods.

New Features

• The following fields have been added:

  Resource	Field(s)
  Advertisers.Audit Response Body	adGroupCriteriaCount campaignCriteriaCount channelsCount negativeKeywordListsCount negativelyTargetedChannelsCount

• The following list methods are now filterable by the following fields:

  Method	Field(s)
  advertisers.list	advertiserId displayName
  advertisers.campaigns.list	campaignId displayName
  advertisers.insertionOrders.list	budget.budget_segments.date_range.end_date displayName
  advertisers.lineItems.list	displayName lineItemId
  targetingTypes.targetingOptions.list	carrierAndIspDetails.type geoRegionDetails.geo_region_type

August 4, 2020

Launched new user management, partner, and partner targeting services. Introduced tools to help users proactively avoid reaching account entity limits. Added support for audio line items and the use of custom bidding algorithms in line items and insertion order bid strategies.

New Features

• The following services have been added:

  Service	Method(s)
  customBiddingAlgorithms	get list
  partners	bulkEditPartnerAssignedTargetingOptions get list
  partners.targetingTypes.assignedTargetingOptions	create delete get list
  users	bulkEditAssignedUserRoles create delete get list patch

• The following methods have been added:

  Service	Method(s)
  advertisers	audit

• The following fields have been added:

  Resource	Field(s)
  MaximizeSpendBidStrategy	customBiddingAlgorithmId
  PerformanceGoalBidStrategy	customBiddingAlgorithmId

• The following enum values have been added:

  Enum	Value(s)
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

• The following list methods are now able to be ordered and filtered by the following fields:

  Method	Field(s)
  advertisers.lineItems.list	flight.dateRange.endDate

• The following scopes have been added to use for the following services:

  Scope	Service(s)
  https://www.googleapis.com/auth/display-video-user-management	users

June 24, 2020

Launched a small update adding a create method for partner and advertiser channels, new FirstAndThirdPartyAudience fields, and additional exchange enum values.

New Features

• The following services have been added:

  Service	Method(s)
  advertisers.channels	create
  partners.channels	create

• The following fields have been added:

  Resource	Field(s)
  FirstAndThirdPartyAudience	activeDisplayAudienceSize audienceSource audienceType description displayAudienceSize displayDesktopAudienceSize displayMobileAppAudienceSize displayMobileWebAudienceSize gmailAudienceSize membershipDurationDays youtubeAudienceSize

• The following enum values have been added:

  Enum	Value(s)
  Exchange	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

• The following list methods are now filterable by the following fields:

  Method	Field(s)
  advertisers.creatives.list	creativeId

June 02, 2020

Introduced the ability to create, patch, and populate a subset of targetable entities and added the ability to modify advertiser-level targeting for three targeting types: channel, digital content label exclusion, and sensitive category exclusion.

New Features

• The following services have been added:

  Service	Method(s)
  advertisers.channels.sites	bulkEdit create delete list
  advertisers.locationLists.assignedLocations	bulkEdit create delete list
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit create delete list
  advertisers.targetingTypes.assignedTargetingOptions	create delete get list
  inventorySourceGroups.assignedInventorySources	bulkEdit create delete list
  partners.channels.sites	bulkEdit create delete list

• The following methods have been added:

  Service	Method(s)
  advertisers	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	patch
  advertisers.locationLists	create patch
  advertisers.negativeKeywordLists	create delete patch
  inventorySourceGroups	create delete patch
  partners.channels	patch

• The following fields have been added:

  Resource	Field(s)
  advertiser	servingConfig
  creative	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	campaignBudgetId

April 27, 2020

Launched a large feature set, expanding the scope of the API beyond SDF. Added core resource management that allows you to create, retrieve, update, and delete entities such as advertisers, campaigns, insertion orders, line items and creatives. New capabilities also allow the editing of targeting at the line item level.

New Features

The following services have been added:

Service	Method(s)
advertisers	create delete get list patch
advertisers.assets	upload
advertisers.campaigns	create delete get list patch
advertisers.channels	get list
advertisers.creatives	create delete get list patch
advertisers.insertionOrders	create delete get list patch
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions create delete get list patch
advertisers.lineItems.targetingTypes.assignedTargetingOptions	create delete get list
advertisers.locationLists	get list
advertisers.negativeKeywordLists	get list
combinedAudiences	get list
customLists	get list
firstAndThirdPartyAudiences	get list
floodlightGroups	get patch
googleAudiences	get list
inventorySourceGroups	get list
inventorySources	get list
partners.channels	get list
partners.channels	get list

March 09, 2020

Launched Display & Video 360 API v1. This is the initial version of the API.

Known issues

None.