This page provides release notes for the Display & Video 360 API.
Latest API version: v3
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 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 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
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
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 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 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 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 The following fields have been added:
Resource Field(s) User YoutubeAndPartnersInventorySourceConfig
v2
The following methods have been added:
Service Method(s) floodlightGroups.floodlightActivities The following fields have been added:
Resource Field(s) User YoutubeAndPartnersInventorySourceConfig
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 MobileDeviceIdList
v2
The following fields have been added:
Resource Field(s) ContactInfoList MobileDeviceIdList
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 toTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
resources. - A new boolean
enableOptimizedTargeting
field, which replaces thetargetingExpansionLevel
field in theTargetingExpansionConfig
object. - The requirement of the
billingConfig
field in theAdvertiser
resource, which must be included when makingadvertisers.create
requests, and a newbillingConfig
field in thePartner
resource. - New
AdGroup
andAdGroupAd
resources that replace theYoutubeAdGroup
andYoutubeAdGroupAd
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 advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules 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 inTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
resources.advertisers.locationLists.assignedLocations.create Now supports creating AssignedLocation
resources inTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
resources.The following query parameters have been added:
Method Parameter(s) inventorySources.get The following fields have been made required:
Resource Field(s) Advertiser The following fields have been added:
Resource Field(s) BiddingStrategy InsertionOrder Partner TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig 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 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 advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions The following fields have been added:
Service Method(s) AssignedTargetingOption YoutubeAndPartnersSettings 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 AssignedTargetingOption 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:
v1
The max page size has been increased for the following list methods:
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 theassignedTargetingOptionId
or the enum value, identified by the newassignedTargetingOptionIdAlias
field in theAssignedTargetingOption
resource. - The line item
bulkUpdate
request was not correctly using theadvertisersId
request parameter, returning an error. With this update, the method has been fixed and the request parameter has been renamed from theadvertisersId
toadvertiserId
.
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 advertisers.lineItems
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
andlist
methods in theadvertisers.lineItems
andadvertisers.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 theentityStatus
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 thetargetingTypes.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
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
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. TheassignedTargetingOptionId
field forAssignedTargetingOption
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:
The following fields have been removed in v2:
The following fields have been made required in v2:
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 inventorySources The following fields have been added:
Resource Field(s) CustomBiddingAlgorithm InventorySource The following enum values have been added:
Enum Value(s) SdfVersion The following list methods are now filterable by the following properties:
Method Field(s) advertisers.creatives.list
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 InsertionOrder MaximizeSpendBidStrategy TargetingOption The following enum values have been added:
Enum Value(s) TargetingType
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 The following fields have been added:
Resource Field(s) FirstAndThirdPartyAudience InsertionOrder LineItem
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 TargetingOption The following enum values have been added:
Enum Value(s) TargetingType
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 createcustomBiddingScripts
.
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 customBiddingAlgorithms.scripts media The following enum values have been added:
Enum Value(s) SdfVersion
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 CustomBiddingAlgorithm TargetingOption TargetingOptions.search Request Body The following enum values have been added:
Enum Value(s) CustomBiddingAlgorithmType Exchange TargetingType The following list methods are now filterable by the following properties:
Method Field(s) customBiddingAlgorithms.list
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 TargetingOption The following enum values have been added:
Enum Value(s) TargetingType The max page size has been increased for the following list methods:
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 The following fields have been added:
Resource Field(s) Advertiser AssignedTargetingOption TargetingOption The following enum values have been added:
Enum Value(s) AssignedTargetingOption.Recency Exchange TargetingType 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 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
orcreatedNegativeKeywords
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:
The following fields have been added:
Resource Field(s) AssignedTargetingOption.AppAssignedTargetingOptionDetails 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 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions The following fields have been added:
Resource Field(s) Creative The following enum values have been added:
Enum Value(s) ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
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 LineItem The following enum values have been added:
Enum Value(s) Exchange GoogleAudienceType LineItemType SdfVersion The following list methods are now able to be ordered and filtered by the following fields:
Method Field(s) advertisers
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 The following enum values have been added:
Enum Value(s) Exchange LineItemWarningMessage The following list methods are now able to be ordered and filtered by the following fields:
Method Field(s) advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
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 The following fields have been added:
Resource Field(s) AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight The following enum values have been added:
Enum Value(s) LineItemFlightDateType The following list methods are now filterable by the following fields:
Method Field(s) advertisers.lineItems.list
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 The following enum values have been added:
Enum Value(s) PerformanceGoalType The following list methods are now filterable by the following fields:
Method Field(s) advertisers.lineItems.list
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 The following list methods are now filterable by the following fields:
Method Field(s) advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
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 partners partners.targetingTypes.assignedTargetingOptions users The following methods have been added:
Service Method(s) advertisers The following fields have been added:
Resource Field(s) MaximizeSpendBidStrategy PerformanceGoalBidStrategy The following enum values have been added:
Enum Value(s) BiddingStrategyPerformanceGoalType LineItemType The following list methods are now able to be ordered and filtered by the following fields:
Method Field(s) advertisers.lineItems.list The following scopes have been added to use for the following services:
Scope Service(s) https://www.googleapis.com/auth/display-video-user-management
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 partners.channels The following fields have been added:
Resource Field(s) FirstAndThirdPartyAudience The following enum values have been added:
Enum Value(s) Exchange The following list methods are now filterable by the following fields:
Method Field(s) advertisers.creatives.list
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:
The following methods have been added:
Service Method(s) advertisers advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels The following fields have been added:
Resource Field(s) advertiser creative insertionOrder.insertionOrderBudgetSegment
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:
March 09, 2020
Launched Display & Video 360 API v1. This is the initial version of the API.
Known issues
None.