type CreativeAsset (v202508)

  • A CreativeAsset is an asset that can be used in creatives.

  • Key fields of a CreativeAsset include assetId, assetByteArray, fileName, fileSize, assetUrl, size, clickTags, and imageDensity.

  • The assetId is generated by Google, while assetByteArray is required for creation or updating the asset content.

  • fileName is required when creating a new asset, fileSize, assetUrl, size, and clickTags are read-only.

  • imageDensity is an optional attribute that indicates the display density of the image and defaults to ONE_TO_ONE.
Service
CreativeService
Dependencies
AspectRatioImageCreative AssetCreativeTemplateVariab... BaseImageCreative CustomCreativeAsset Html5Creative ImageCreative
▼
CreativeAsset

A CreativeAsset is an asset that can be used in creatives.

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

Field

assetId

xsd:long

The ID of the asset. This attribute is generated by Google upon creation.

assetByteArray

xsd:base64Binary

The content of the asset as a byte array. This attribute is required when creating the creative that contains this asset if an assetId is not provided.

When updating the content, pass a new byte array, and set assetId to null. Otherwise, this field can be null.

The assetByteArray will be null when the creative is retrieved.

fileName

xsd:string

The file name of the asset. This attribute is required when creating a new asset (e.g. when assetByteArray is not null).

fileSize

xsd:long

The file size of the asset in bytes. This attribute is read-only.

assetUrl

xsd:string

A URL where the asset can be previewed at. This field is read-only and set by Google.

size

Size

The size of the asset. Note that this may not always reflect the actual physical size of the asset, but may reflect the expected size. This attribute is read-only and is populated by Google.

clickTags

ClickTag[]

The click tags of the asset. This field is read-only.

imageDensity

ImageDensity

The display density of the image. This is the ratio between a dimension in pixels of the image and the dimension in pixels that it should occupy in device-independent pixels when displayed. This attribute is optional and defaults to ONE_TO_ONE.

Enumerations
ONE_TO_ONE
Indicates that there is a 1:1 ratio between the dimensions of the raw image and the dimensions that it should be displayed at in device-independent pixels.
THREE_TO_TWO
Indicates that there is a 3:2 ratio between the dimensions of the raw image and the dimensions that it should be displayed at in device-independent pixels.
TWO_TO_ONE
Indicates that there is a 2:1 ratio between the dimensions of the raw image and the dimensions that it should be displayed at in device-independent pixels.
UNKNOWN
The value returned if the actual value is not exposed by the requested API version.