Caution: You are viewing documentation for the API's REST interface. Most of our official client libraries use gRPC. See the REST Introduction for details.

Asset

Stay organized with collections Save and categorize content based on your preferences.

Asset is a part of an ad which can be shared across multiple ads. It can be an image (ImageAsset), a video (YoutubeVideoAsset), etc. Assets are immutable and cannot be removed. To stop an asset from serving, remove the asset from the entity that is using it.

JSON representation
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "source": enum (AssetSource),
  "policySummary": {
    object (AssetPolicySummary)
  },
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "mediaBundleAsset": {
    object (MediaBundleAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "leadFormAsset": {
    object (LeadFormAsset)
  },
  "bookOnGoogleAsset": {
    object (BookOnGoogleAsset)
  },
  "promotionAsset": {
    object (PromotionAsset)
  },
  "calloutAsset": {
    object (CalloutAsset)
  },
  "structuredSnippetAsset": {
    object (StructuredSnippetAsset)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  },
  "pageFeedAsset": {
    object (PageFeedAsset)
  },
  "dynamicEducationAsset": {
    object (DynamicEducationAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "hotelCalloutAsset": {
    object (HotelCalloutAsset)
  },
  "callAsset": {
    object (CallAsset)
  },
  "priceAsset": {
    object (PriceAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "dynamicRealEstateAsset": {
    object (DynamicRealEstateAsset)
  },
  "dynamicCustomAsset": {
    object (DynamicCustomAsset)
  },
  "dynamicHotelsAndRentalsAsset": {
    object (DynamicHotelsAndRentalsAsset)
  },
  "dynamicFlightsAsset": {
    object (DynamicFlightsAsset)
  },
  "discoveryCarouselCardAsset": {
    object (DiscoveryCarouselCardAsset)
  },
  "dynamicTravelAsset": {
    object (DynamicTravelAsset)
  },
  "dynamicLocalAsset": {
    object (DynamicLocalAsset)
  },
  "dynamicJobsAsset": {
    object (DynamicJobsAsset)
  }
  // End of list of possible types for union field asset_data.
}
Fields
resourceName

string

Immutable. The resource name of the asset. Asset resource names have the form:

customers/{customerId}/assets/{asset_id}

type

enum (AssetType)

Output only. Type of the asset.

finalUrls[]

string

A list of possible final URLs after all cross domain redirects.

finalMobileUrls[]

string

A list of possible final mobile URLs after all cross domain redirects.

urlCustomParameters[]

object (CustomParameter)

A list of mappings to be used for substituting URL custom parameter tags in the trackingUrlTemplate, finalUrls, and/or finalMobileUrls.

source

enum (AssetSource)

Output only. Source of the asset.

policySummary

object (AssetPolicySummary)

Output only. Policy information for the asset.

id

string (int64 format)

Output only. The ID of the asset.

name

string

Optional name of the asset.

trackingUrlTemplate

string

URL template for constructing a tracking URL.

finalUrlSuffix

string

URL template for appending params to landing page URLs served with parallel tracking.

Union field asset_data. The specific type of the asset. asset_data can be only one of the following:
youtubeVideoAsset

object (YoutubeVideoAsset)

Immutable. A YouTube video asset.

mediaBundleAsset

object (MediaBundleAsset)

Immutable. A media bundle asset.

imageAsset

object (ImageAsset)

Output only. An image asset.

textAsset

object (TextAsset)

Immutable. A text asset.

leadFormAsset

object (LeadFormAsset)

A lead form asset.

bookOnGoogleAsset

object (BookOnGoogleAsset)

A book on google asset.

promotionAsset

object (PromotionAsset)

A promotion asset.

calloutAsset

object (CalloutAsset)

A callout asset.

structuredSnippetAsset

object (StructuredSnippetAsset)

A structured snippet asset.

pageFeedAsset

object (PageFeedAsset)

A page feed asset.

dynamicEducationAsset

object (DynamicEducationAsset)

A dynamic education asset.

mobileAppAsset

object (MobileAppAsset)

A mobile app asset.

hotelCalloutAsset

object (HotelCalloutAsset)

A hotel callout asset.

callAsset

object (CallAsset)

A call asset.

priceAsset

object (PriceAsset)

A price asset.

callToActionAsset

object (CallToActionAsset)

Immutable. A call to action asset.

dynamicRealEstateAsset

object (DynamicRealEstateAsset)

A dynamic real estate asset.

dynamicCustomAsset

object (DynamicCustomAsset)

A dynamic custom asset.

dynamicHotelsAndRentalsAsset

object (DynamicHotelsAndRentalsAsset)

A dynamic hotels and rentals asset.

dynamicFlightsAsset

object (DynamicFlightsAsset)

A dynamic flights asset.

dynamicTravelAsset

object (DynamicTravelAsset)

A dynamic travel asset.

dynamicLocalAsset

object (DynamicLocalAsset)

A dynamic local asset.

dynamicJobsAsset

object (DynamicJobsAsset)

A dynamic jobs asset.

AssetType

Enum describing possible types of asset.

<
Enums
UNSPECIFIED Not specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
YOUTUBE_VIDEO YouTube video asset.
MEDIA_BUNDLE Media bundle asset.
IMAGE Image asset.
TEXT Text asset.
LEAD_FORM Lead form asset.
BOOK_ON_GOOGLE Book on Google asset.
PROMOTION Promotion asset.
CALLOUT Callout asset.
STRUCTURED_SNIPPET Structured Snippet asset.
PAGE_FEED Page Feed asset.
DYNAMIC_EDUCATION Dynamic Education asset.
MOBILE_APP Mobile app asset.
HOTEL_CALLOUT Hotel callout asset.
CALL Call asset.
PRICE Price asset.