REST Resource: sellers.creativeAssets

  • CreativeAsset details a creative asset that will be shown on a screen, including its name, external ID, suspended status, creative ID, video transcodes, creative type, and an expiring URI for download.

  • An ExpiringUri provides a temporary URI for downloading a creative asset with a specified expiration time.

  • Transcode represents video transcode information, including MIME type, dimensions, bit rate, frame rate, audio bit rate, audio sample rate, file size, and a serving URI.

  • The available methods for creative assets include retrieving a single asset, listing all assets, and updating an existing asset.

Resource: CreativeAsset

Details (specific to each seller) about a creative asset that will be shown on a screen.

JSON representation 
{
  "name": string,
  "externalId": string,
  "suspended": boolean,
  "creativeId": string,
  "videoTranscodes": [
    {
      object (Transcode)
    }
  ],
  "creativeType": enum (CreativeType),
  "expiringUri": {
    object (ExpiringUri)
  }
}
Fields
name

string

The resource name of the creative asset in the format: sellers/{seller}/creativeAssets/{creativeAsset}.
externalId

string

Seller-managed ID presumably in their own system. Once set unlikely to change.
suspended

boolean

Output only. Whether the creative is suspended by the buyer or by the system.
creativeId

string (int64 format)

Output only. DV360 creative ID.
videoTranscodes[]

object (Transcode)

Output only. List of transcodes for video creatives.
creativeType

enum (CreativeType)

Output only. The type of the creative.
expiringUri

object (ExpiringUri)

Output only. The URI used to download the creative asset before expireTime.

ExpiringUri

JSON representation 
{
  "uri": string,
  "expireTime": string
}
Fields
uri

string

The URI of the creative asset that is valid before expireTime.
expireTime

string (Timestamp format)

The expiration time after which the URI is no longer valid.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

Transcode

Represent the video transcode information.

JSON representation 
{
  "mimeType": string,
  "widthPixels": integer,
  "heightPixels": integer,
  "bitRate": string,
  "frameRate": number,
  "audioBitRate": string,
  "audioSampleRate": string,
  "fileSizeBytes": string,
  "uri": string
}
Fields
mimeType

string

The MIME type of the transcoded file.
widthPixels

integer

Width of the transcode in pixels.
heightPixels

integer

Height of the transcode in pixels.
bitRate

string (int64 format)

The transcoding bit rate of the transcoded video, in kbps.
frameRate

number

The frame rate of the transcoded video, in fps.
audioBitRate

string (int64 format)

The bit rate for the audio stream of a transcoded video for video asset, or the bit rate for the transcoded audio for audio asset, in kbps.
audioSampleRate

string (int64 format)

The sample rate for the audio stream of a transcoded video for video asset, or the sample rate for the transcoded audio for audio asset, in Hz.
fileSizeBytes

string (int64 format)

The size of the transcoded file, in bytes.
uri

string

The serving uri of the asset.

Methods

get

 Retrieves an individual creative asset.

list

 Lists creative assets.

patch

 Updates an existing creative asset.