Reminder: v201708 will be sunset on August 31, 2018.

type AdUnit (v201702)

An AdUnit represents a chunk of identified inventory for the publisher. It contains all the settings that need to be associated with inventory in order to serve ads to it. An AdUnit can also be the parent of other ad units in the inventory hierarchy.


Namespace
https://www.google.com/apis/ads/publisher/v201702

Field

id

xsd:string

Uniquely identifies the AdUnit. This value is read-only and is assigned by Google when an ad unit is created. This attribute is required for updates.

parentId

xsd:string

The ID of the ad unit's parent. Every ad unit has a parent except for the root ad unit, which is created by Google. This attribute is required when creating the ad unit. Once the ad unit is created this value will be read-only.

hasChildren

xsd:boolean

This field is set to true if the ad unit has any children. This attribute is read-only and is populated by Google.

parentPath

AdUnitParent[]

The path to this ad unit in the ad unit hierarchy represented as a list from the root to this ad unit's parent. For root ad units, this list is empty. This attribute is read-only and is populated by Google.

name

xsd:string

The name of the ad unit. This attribute is required and its maximum length is 255 characters. This attribute must also be case-insensitive unique.

description

xsd:string

A description of the ad unit. This value is optional and its maximum length is 65,535 characters.

targetWindow

AdUnit.TargetWindow

The value to use for the HTML link's target attribute. This value is optional and will be interpreted as TargetWindow.TOP if left blank.


Enumerations
TOP
Specifies that the link should open in the full body of the page.
BLANK
Specifies that the link should open in a new window.

status

InventoryStatus

The status of this ad unit. It defaults to InventoryStatus.ACTIVE. This value cannot be updated directly using InventoryService.updateAdUnit. It can only be modified by performing actions via InventoryService.performAdUnitAction.


Enumerations
ACTIVE
The object is active.
INACTIVE
The object is no longer active.
ARCHIVED
The object has been archived.

adUnitCode

xsd:string

A string used to uniquely identify the ad unit for the purposes of serving the ad. This attribute is optional and can be set during ad unit creation. If it is not provided, it will be assigned by Google based off of the inventory unit ID. Once an ad unit is created, its adUnitCode cannot be changed.

adUnitSizes

AdUnitSize[]

The permissible creative sizes that can be served inside this ad unit. This attribute is optional. This attribute replaces the sizes attribute.

mobilePlatform

MobilePlatform

The platform associated with a mobile AdUnit, i.e. whether this ad unit appears in a mobile application or in a mobile web site. This attribute can only be used with TargetPlatform.MOBILE ad units. This attribute is optional and defaults to MobilePlatform.SITE.


Enumerations
SITE
The ad unit appears in a mobile site.
APPLICATION
The ad unit appears in a moible application.

explicitlyTargeted

xsd:boolean

If this field is set to true, then the AdUnit will not be implicitly targeted when its parent is. Traffickers must explicitly target such an ad unit or else no line items will serve to it. This feature is only available for DFP Premium accounts.

inheritedAdSenseSettings

AdSenseSettingsInheritedPro...

AdSense specific settings. This value is optional and if left blank will be inherited from the parent ad unit.

partnerId

xsd:long

The unique ID of the Company, which is of type Company.Type.AFFILIATE_DISTRIBUTION_PARTNER, to which this ad unit belongs. This attribute is optional. Setting this attribute to null will disassociate the partner from this ad unit.

This field is deprecated. All companies of type Company.Type.AFFILIATE_DISTRIBUTION_PARTNER were changed to Company.Type.PARTNER.

appliedLabelFrequencyCaps

LabelFrequencyCap[]

The set of label frequency caps applied directly to this ad unit. There is a limit of 10 label frequency caps per ad unit.

effectiveLabelFrequencyCaps

LabelFrequencyCap[]

Contains the set of labels applied directly to the ad unit as well as those inherited from parent ad units. This field is readonly and is assigned by Google.

appliedLabels

AppliedLabel[]

The set of labels applied directly to this ad unit.

effectiveAppliedLabels

AppliedLabel[]

Contains the set of labels applied directly to the ad unit as well as those inherited from the parent ad units. If a label has been negated, only the negated label is returned. This field is readonly and is assigned by Google.

effectiveTeamIds

xsd:long[]

The IDs of all teams that this ad unit is on as well as those inherited from parent ad units. This value is read-only and is set by Google.

appliedTeamIds

xsd:long[]

The IDs of all teams that this ad unit is on directly.

lastModifiedDateTime

DateTime

The date and time this ad unit was last modified.

smartSizeMode

SmartSizeMode

The smart size mode for this ad unit. This attribute is optional and defaults to SmartSizeMode.NONE for fixed sizes.


Enumerations
UNKNOWN
The value returned if the actual value is not exposed by the requested API version.
NONE
Fixed size mode (default).
SMART_BANNER
The height is fixed for the request, the width is a range.
DYNAMIC_SIZE
Height and width are ranges.

refreshRate

xsd:int

The interval in seconds which ad units in mobile apps automatically refresh. Valid values are between 30 and 120 seconds. This attribute is optional and only applies to ad units in mobile apps. If this value is not set, then the mobile app ad will not refresh.

isSharedByDistributor

xsd:boolean

Whether this ad unit is shared by a distributor network. When this field is true, then crossSellingDistributor will contain data for the distributor network. This attribute is read-only.

This field is deprecated.

crossSellingDistributor

CrossSellingDistributor

If this ad unit is shared by a distributor network, then this field will contain data describing that distributor network. This attribute is read-only.

This field is deprecated.

externalSetTopBoxChannelId

xsd:string

Specifies an ID for a channel in an external set-top box campaign management system. This attribute is only meaningful if isSetTopBoxEnabled is true. This attribute is read-only.

isSetTopBoxEnabled

xsd:boolean

Flag that specifies whether this ad unit represents an external set-top box channel. This attribute is read-only.

Send feedback about...

DoubleClick for Publishers API
DoubleClick for Publishers API
Need help? Visit our support page.