type LineItemCreativeAssociation (v202402)

A LineItemCreativeAssociation associates a Creative or CreativeSet with a LineItem so that the creative can be served in ad units targeted by the line item.


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

Field

lineItemId

xsd:long

The ID of the LineItem to which the Creative should be associated. This attribute is required.

creativeId

xsd:long

The ID of the Creative being associated with a LineItem.

This attribute is required if this is an association between a line item and a creative.
This attribute is ignored if this is an association between a line item and a creative set.

If this is an association between a line item and a creative, when retrieving the line item creative association, the creativeId will be the creative's ID.
If this is an association between a line item and a creative set, when retrieving the line item creative association, the creativeId will be the ID of the master creative.

creativeSetId

xsd:long

The ID of the CreativeSet being associated with a LineItem. This attribute is required if this is an association between a line item and a creative set.

This field will be null when retrieving associations between line items and creatives not belonging to a set.

manualCreativeRotationWeight

xsd:double

The weight of the Creative. This value is only used if the line item's creativeRotationType is set to CreativeRotationType.MANUAL. This attribute is optional and defaults to 10.

sequentialCreativeRotationIndex

xsd:int

The sequential rotation index of the Creative. This value is used only if the associated line item's LineItem.creativeRotationType is set to CreativeRotationType.SEQUENTIAL. This attribute is optional and defaults to 1.

startDateTime

DateTime

Overrides the value set for LineItem.startDateTime. This value is optional and is only valid for Ad Manager 360 networks. If unset, the LineItem.startDateTime will be used.

startDateTimeType

StartDateTimeType

Specifies whether to start serving to the LineItemCreativeAssociation right away, in an hour, etc. This attribute is optional and defaults to StartDateTimeType.USE_START_DATE_TIME.


Enumerations
USE_START_DATE_TIME
Use the value in startDateTime.
IMMEDIATELY
The entity will start serving immediately. startDateTime in the request is ignored and will be set to the current time. Additionally, startDateTimeType will be set to StartDateTimeType.USE_START_DATE_TIME.
ONE_HOUR_FROM_NOW
The entity will start serving one hour from now. startDateTime in the request is ignored and will be set to one hour from the current time. Additionally, startDateTimeType will be set to StartDateTimeType.USE_START_DATE_TIME.
UNKNOWN
The value returned if the actual value is not exposed by the requested API version.

endDateTime

DateTime

Overrides LineItem.endDateTime. This value is optional and is only valid for Ad Manager 360 networks. If unset, the LineItem.endDateTime will be used.

destinationUrl

xsd:string

Overrides the value set for HasDestinationUrlCreative.destinationUrl. This value is optional and is only valid for Ad Manager 360 networks.

sizes

Size[]

Overrides the value set for Creative.size, which allows the creative to be served to ad units that would otherwise not be compatible for its actual size. This value is optional.

status

LineItemCreativeAssociation...

The status of the association. This attribute is read-only.


Enumerations
ACTIVE
The association is active and the associated Creative can be served.
NOT_SERVING
The association is active but the associated Creative may not be served, because its size is not targeted by the line item.
INACTIVE
The association is inactive and the associated Creative is ineligible for being served.
UNKNOWN
The value returned if the actual value is not exposed by the requested API version.

stats

LineItemCreativeAssociation...

Contains trafficking statistics for the association. This attribute is readonly and is populated by Google. This will be null in case there are no statistics for the association yet.

lastModifiedDateTime

DateTime

The date and time this association was last modified.

targetingName

xsd:string

Specifies CreativeTargeting for this line item creative association.

This attribute is optional. It should match the creative targeting specified on the corresponding CreativePlaceholder in the LineItem that is being associated with the Creative.