Release Notes

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

Latest API version: v1

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.