You can retrieve YouTube & Partners line items, their ad groups and ad resources, and targeting relevant to YouTube & Partners ad serving using Display & Video 360 API. YouTube & Partners resources and targeting can only be created or updated through the UI.
This page describes how to use the Display & Video 360 API to identify YouTube & Partners resources and retrieve relevant targeting, and how to create and update YouTube & Partners resources in bulk using Structured Data Files (SDF) in the UI.
Identify YouTube & Partners resources
YouTube & Partners resources consist of certain types of line items, Ad Groups , and Ads .
Line Items
Line items of the following LineItemType
values are YouTube &
Partners line items and cannot be created or updated:
-
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_NON_SKIPPABLE_OVER_THE_TOP -
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH -
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP -
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE -
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP -
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY -
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
Settings specific to YouTube & Partners line items can be retrieved from the youtubeAndPartnersSettings
field of the LineItem
resource.
YouTube Ad Groups and Ads
YouTube Ad Groups and Ads are child resources under YouTube & Partner line items that allow for further specification.
A YouTube & Partners line item can have multiple AdGroup
resources under it, each with its own additional
targeting
and bidding strategy
. Under each AdGroup
resource can be multiple AdGroupAd
resources of the same ad format
, each with its own creative
information
and list of additional tracking
URLs
.
Retrieve targeting
Targeting used for serving YouTube & Partners ads is assigned at the advertiser level, line item level, and Ad Group level.
YouTube & Partners targeting inherited from parent resources are not reflected in the targeting settings of child resources, as is standard for non-YouTube & Partners resources .
In order to retrieve all targeting relevant to the serving of a YouTube & Partners ad, you must:
- retrieve targeting assigned to its parent advertiser using
advertisers.listAssignedTargetingOptions, - retrieve targeting assigned to its parent line item using
advertisers.lineItems.bulkListAssignedTargetingOptions, - and retrieve targeting assigned to its parent ad group using
advertisers.adGroups.bulkListAssignedTargetingOptions.
Attempting to modify YouTube targeting
As is the case with YouTube & Partners resources, you cannot modify YouTube & Partners targeting using the Display & Video 360 API. Any attempt to modify the following targeting will return an error:
- Targeting assigned at any level of the following targeting types
:
TARGETING_TYPE_SESSION_POSITION,TARGETING_TYPE_YOUTUBE_CHANNEL, andTARGETING_TYPE_YOUTUBE_VIDEO. - Targeting assigned to YouTube & Partners line item resources .
- Targeting assigned to
AdGroupresources.
Create and update using SDF UI upload
Although you cannot create or update YouTube & Partners resources using the Display & Video 360 API, you can create or update YouTube & Partners line items, ad groups, and ads in bulk using Structured Data File (SDF) upload through the Display & Video 360 UI .
These resources are represented in SDF through the Line Item , Youtube Ad Group , and YouTube Ad file formats.
You can generate and download Structured Data Files using Display & Video 360 API . Edit existing rows to make changes to existing resources or add new rows for create new resources, and upload the updated files through the Display & Video 360 UI.
