Register for one of our Google Ads API Migration Workshops (October 5, 2021 - October 14, 2021)

asset

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.

Attributed resources
customer

Fields from the above resources may be selected along with this resource in your SELECT and WHERE clauses. These fields will not segment metrics in your SELECT clause.

Fields/Segments/Metrics

This page shows all metrics and segments that can be put in the same SELECT clause as the fields of asset. However, when you specify asset in the FROM clause, some metrics and segments cannot be used. Use the following filter to show only the fields that can be used when asset is specified in the FROM clause.

Is asset specified in the FROM clause of your query?

 Resource fields
book_on_google_asset
callout_asset.ad_schedule_targets
callout_asset.callout_text
callout_asset.end_date
callout_asset.start_date
final_mobile_urls
final_url_suffix
final_urls
id
image_asset.file_size
image_asset.full_size.height_pixels
image_asset.full_size.url
image_asset.full_size.width_pixels
image_asset.mime_type
lead_form_asset.background_image_asset
lead_form_asset.business_name
lead_form_asset.call_to_action_description
lead_form_asset.call_to_action_type
lead_form_asset.custom_disclosure
lead_form_asset.delivery_methods
lead_form_asset.description
lead_form_asset.desired_intent
lead_form_asset.fields
lead_form_asset.headline
lead_form_asset.post_submit_call_to_action_type
lead_form_asset.post_submit_description
lead_form_asset.post_submit_headline
lead_form_asset.privacy_policy_url
name
policy_summary.approval_status
policy_summary.policy_topic_entries
policy_summary.review_status
promotion_asset.ad_schedule_targets
promotion_asset.discount_modifier
promotion_asset.end_date
promotion_asset.language_code
promotion_asset.money_amount_off.amount_micros
promotion_asset.money_amount_off.currency_code
promotion_asset.occasion
promotion_asset.orders_over_amount.amount_micros
promotion_asset.orders_over_amount.currency_code
promotion_asset.percent_off
promotion_asset.promotion_code
promotion_asset.promotion_target
promotion_asset.redemption_end_date
promotion_asset.redemption_start_date
promotion_asset.start_date
resource_name
sitelink_asset.ad_schedule_targets
sitelink_asset.description1
sitelink_asset.description2
sitelink_asset.end_date
sitelink_asset.link_text
sitelink_asset.start_date
structured_snippet_asset.header
structured_snippet_asset.values
text_asset.text
tracking_url_template
type
url_custom_parameters
youtube_video_asset.youtube_video_id
youtube_video_asset.youtube_video_title
 Segments
conversion_action
conversion_action_category
conversion_action_name
conversion_adjustment
conversion_lag_bucket
conversion_or_adjustment_lag_bucket
external_conversion_source

asset.book_on_google_asset

Field descriptionA book on google asset.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v8.common.BookOnGoogleAsset
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

asset.callout_asset.ad_schedule_targets

Field descriptionList of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v8.common.AdScheduleInfo
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

asset.callout_asset.callout_text

Field descriptionRequired. The callout text. The length of this string should be between 1 and 25, inclusive.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.callout_asset.end_date

Field descriptionLast date of when this asset is effective and still serving, in yyyy-MM-dd format.
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.callout_asset.start_date

Field descriptionStart date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.final_mobile_urls

Field descriptionA list of possible final mobile URLs after all cross domain redirects.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

asset.final_url_suffix

Field descriptionURL template for appending params to landing page URLs served with parallel tracking.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.final_urls

Field descriptionA list of possible final URLs after all cross domain redirects.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

asset.id

Field descriptionOutput only. The ID of the asset.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.image_asset.file_size

Field descriptionFile size of the image asset in bytes.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.image_asset.full_size.height_pixels

Field descriptionHeight of the image.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.image_asset.full_size.url

Field descriptionA URL that returns the image with this height and width.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.image_asset.full_size.width_pixels

Field descriptionWidth of the image.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.image_asset.mime_type

Field descriptionMIME type of the image asset.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v8.enums.MimeTypeEnum.MimeType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.lead_form_asset.background_image_asset

Field descriptionAsset resource name of the background image. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%).
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.lead_form_asset.business_name

Field descriptionRequired. The name of the business being advertised.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.lead_form_asset.call_to_action_description

Field descriptionRequired. Text giving a clear value proposition of what users expect once they expand the form.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.lead_form_asset.call_to_action_type

Field descriptionRequired. Pre-defined display text that encourages user to expand the form.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v8.enums.LeadFormCallToActionTypeEnum.LeadFormCallToActionType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.lead_form_asset.custom_disclosure

Field descriptionCustom disclosure shown along with Google disclaimer on the lead form. Accessible to allowed customers only.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.lead_form_asset.delivery_methods

Field descriptionConfigured methods for collected lead data to be delivered to advertiser. Only one method typed as WebhookDelivery can be configured.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v8.common.LeadFormDeliveryMethod
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

asset.lead_form_asset.description

Field descriptionRequired. Detailed description of the expanded form to describe what the form is asking for or facilitating.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.lead_form_asset.desired_intent

Field descriptionDesired intent for the lead form, e.g. more volume or more qualified.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v8.enums.LeadFormDesiredIntentEnum.LeadFormDesiredIntent
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.lead_form_asset.fields

Field descriptionOrdered list of input fields.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v8.common.LeadFormField
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

asset.lead_form_asset.headline

Field descriptionRequired. Headline of the expanded form to describe what the form is asking for or facilitating.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.lead_form_asset.post_submit_call_to_action_type

Field descriptionPre-defined display text that encourages user action after the form is submitted.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v8.enums.LeadFormPostSubmitCallToActionTypeEnum.LeadFormPostSubmitCallToActionType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.lead_form_asset.post_submit_description

Field descriptionDetailed description shown after form submission that describes how the advertiser will follow up with the user.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.lead_form_asset.post_submit_headline

Field descriptionHeadline of text shown after form submission that describes how the advertiser will follow up with the user.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.lead_form_asset.privacy_policy_url

Field descriptionRequired. Link to a page describing the policy on how the collected data is handled by the advertiser/business.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.name

Field descriptionOptional name of the asset.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.policy_summary.approval_status

Field descriptionOutput only. The overall approval status of this asset, calculated based on the status of its individual policy topic entries.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v8.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.policy_summary.policy_topic_entries

Field descriptionOutput only. The list of policy findings for this asset.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v8.common.PolicyTopicEntry
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

asset.policy_summary.review_status

Field descriptionOutput only. Where in the review process this asset is.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v8.enums.PolicyReviewStatusEnum.PolicyReviewStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.promotion_asset.ad_schedule_targets

Field descriptionList of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v8.common.AdScheduleInfo
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

asset.promotion_asset.discount_modifier

Field descriptionA modifier for qualification of the discount.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v8.enums.PromotionExtensionDiscountModifierEnum.PromotionExtensionDiscountModifier
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.promotion_asset.end_date

Field descriptionLast date of when this asset is effective and still serving, in yyyy-MM-dd format.
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.promotion_asset.language_code

Field descriptionThe language of the promotion. Represented as BCP 47 language tag.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.promotion_asset.money_amount_off.amount_micros

Field descriptionAmount in micros. One million is equivalent to one unit.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.promotion_asset.money_amount_off.currency_code

Field descriptionThree-character ISO 4217 currency code.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.promotion_asset.occasion

Field descriptionThe occasion the promotion was intended for. If an occasion is set, the redemption window will need to fall within the date range associated with the occasion.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v8.enums.PromotionExtensionOccasionEnum.PromotionExtensionOccasion
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.promotion_asset.orders_over_amount.amount_micros

Field descriptionAmount in micros. One million is equivalent to one unit.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.promotion_asset.orders_over_amount.currency_code

Field descriptionThree-character ISO 4217 currency code.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.promotion_asset.percent_off

Field descriptionPercentage off discount in the promotion. 1,000,000 = 100%. Either this or money_amount_off is required.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.promotion_asset.promotion_code

Field descriptionA code the user should use in order to be eligible for the promotion.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.promotion_asset.promotion_target

Field descriptionRequired. A freeform description of what the promotion is targeting.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.promotion_asset.redemption_end_date

Field descriptionLast date of when the promotion is eligible to be redeemed, in yyyy-MM-dd format.
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.promotion_asset.redemption_start_date

Field descriptionStart date of when the promotion is eligible to be redeemed, in yyyy-MM-dd format.
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.promotion_asset.start_date

Field descriptionStart date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.resource_name

Field descriptionImmutable. The resource name of the asset. Asset resource names have the form: `customers/{customer_id}/assets/{asset_id}`
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse
Field descriptionList of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v8.common.AdScheduleInfo
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue
Field descriptionFirst line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Field descriptionSecond line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Field descriptionLast date of when this asset is effective and still serving, in yyyy-MM-dd format.
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Field descriptionRequired. URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Field descriptionStart date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.structured_snippet_asset.header

Field descriptionRequired. The header of the snippet. This string should be one of the predefined values at https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.structured_snippet_asset.values

Field descriptionRequired. The values in the snippet. The size of this collection should be between 3 and 10, inclusive. The length of each value should be between 1 and 25 characters, inclusive.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

asset.text_asset.text

Field descriptionText content of the text asset.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.tracking_url_template

Field descriptionURL template for constructing a tracking URL.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.type

Field descriptionOutput only. Type of the asset.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v8.enums.AssetTypeEnum.AssetType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.url_custom_parameters

Field descriptionA list of mappings to be used for substituting URL custom parameter tags in the tracking_url_template, final_urls, and/or final_mobile_urls.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v8.common.CustomParameter
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

asset.youtube_video_asset.youtube_video_id

Field descriptionYouTube video id. This is the 11 character string value used in the YouTube video URL.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset.youtube_video_asset.youtube_video_title

Field descriptionYouTube video title.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

segments.conversion_action

Field descriptionResource name of the conversion action.
CategorySEGMENT
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

segments.conversion_action_category

Field descriptionConversion action category.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.ConversionActionCategoryEnum.ConversionActionCategory
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

segments.conversion_action_name

Field descriptionConversion action name.
CategorySEGMENT
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

segments.conversion_adjustment

Field descriptionThis segments your conversion columns by the original conversion and conversion value vs. the delta if conversions were adjusted. False row has the data as originally stated; While true row has the delta between data now and the data as originally stated. Summing the two together results post-adjustment data.
CategorySEGMENT
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

segments.conversion_lag_bucket

Field descriptionAn enum value representing the number of days between the impression and the conversion.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.ConversionLagBucketEnum.ConversionLagBucket
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

segments.conversion_or_adjustment_lag_bucket

Field descriptionAn enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.ConversionOrAdjustmentLagBucketEnum.ConversionOrAdjustmentLagBucket
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

segments.external_conversion_source

Field descriptionExternal conversion source.
CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v8.enums.ExternalConversionSourceEnum.ExternalConversionSource
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse