The new Search Ads 360 Reporting API is now available. Join the searchads-api-announcements Google group to stay up to date on upcoming enhancements and releases.

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.

asset.call_asset.ad_schedule_targets
Field description	List 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.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.searchads360.v0.common.AdScheduleInfo`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

asset.call_asset.call_conversion_action
Field description	The conversion action to attribute a call conversion to. If not set, the default conversion action is used. This field only has effect if call_conversion_reporting_state is set to USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.call_asset.call_conversion_reporting_state
Field description	Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion.
Category	`ATTRIBUTE`
Data Type	`ENUM DISABLED UNKNOWN UNSPECIFIED USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION`
Type URL	`google.ads.searchads360.v0.enums.CallConversionReportingStateEnum.CallConversionReportingState`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.call_asset.call_only
Field description	Whether the call only shows the phone number without a link to the website. Applies to Microsoft Ads.
Category	`ATTRIBUTE`
Data Type	`BOOLEAN`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.call_asset.call_tracking_enabled
Field description	Whether the call should be enabled on call tracking. Applies to Microsoft Ads.
Category	`ATTRIBUTE`
Data Type	`BOOLEAN`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.call_asset.country_code
Field description	Two-letter country code of the phone number. Examples: 'US', 'us'.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.call_asset.end_date
Field description	Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.call_asset.phone_number
Field description	The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890'
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.call_asset.start_date
Field description	Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.call_asset.use_searcher_time_zone
Field description	Whether to show the call extension in search user's time zone. Applies to Microsoft Ads.
Category	`ATTRIBUTE`
Data Type	`BOOLEAN`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.call_to_action_asset.call_to_action
Field description	Call to action.
Category	`ATTRIBUTE`
Data Type	`ENUM APPLY_NOW BOOK_NOW BUY_NOW CONTACT_US DONATE_NOW DOWNLOAD GET_QUOTE LEARN_MORE ORDER_NOW PLAY_NOW SEE_MORE SHOP_NOW SIGN_UP START_NOW SUBSCRIBE UNKNOWN UNSPECIFIED VISIT_SITE WATCH_NOW`
Type URL	`google.ads.searchads360.v0.enums.CallToActionTypeEnum.CallToActionType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.callout_asset.ad_schedule_targets
Field description	List 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.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.searchads360.v0.common.AdScheduleInfo`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

asset.callout_asset.callout_text
Field description	The callout text. The length of this string should be between 1 and 25, inclusive.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.callout_asset.end_date
Field description	Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.callout_asset.start_date
Field description	Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.callout_asset.use_searcher_time_zone
Field description	Whether to show the asset in search user's time zone. Applies to Microsoft Ads.
Category	`ATTRIBUTE`
Data Type	`BOOLEAN`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.creation_time
Field description	The timestamp when this asset was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.engine_status
Field description	The Engine Status for an asset.
Category	`ATTRIBUTE`
Data Type	`ENUM DISABLED DISAPPROVED REMOVED SERVING SERVING_LIMITED UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.AssetEngineStatusEnum.AssetEngineStatus`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.final_urls
Field description	A list of possible final URLs after all cross domain redirects.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	True

asset.id
Field description	The ID of the asset.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.image_asset.file_size
Field description	File size of the image asset in bytes.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.image_asset.full_size.height_pixels
Field description	Height of the image.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.image_asset.full_size.url
Field description	A URL that returns the image with this height and width.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.image_asset.full_size.width_pixels
Field description	Width of the image.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.image_asset.mime_type
Field description	MIME type of the image asset.
Category	`ATTRIBUTE`
Data Type	`ENUM AUDIO_MP3 AUDIO_WAV FLASH HTML5_AD_ZIP IMAGE_GIF IMAGE_JPEG IMAGE_PNG MSEXCEL MSWORD PDF RTF TEXT_HTML UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.MimeTypeEnum.MimeType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.last_modified_time
Field description	The datetime when this asset was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.location_asset.business_profile_locations
Field description	The list of business locations for the customer. This will only be returned if the Location Asset is syncing from the Business Profile account. It is possible to have multiple Business Profile listings under the same account that point to the same Place ID.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.searchads360.v0.common.BusinessProfileLocation`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

asset.location_asset.location_ownership_type
Field description	The type of location ownership. If the type is BUSINESS_OWNER, it will be served as a location extension. If the type is AFFILIATE, it will be served as an affiliate location.
Category	`ATTRIBUTE`
Data Type	`ENUM AFFILIATE BUSINESS_OWNER UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.LocationOwnershipTypeEnum.LocationOwnershipType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.location_asset.place_id
Field description	Place IDs uniquely identify a place in the Google Places database and on Google Maps. This field is unique for a given customer ID and asset type. See https://developers.google.com/places/web-service/place-id to learn more about Place ID.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.mobile_app_asset.app_id
Field description	Required. A string that uniquely identifies a mobile application. It should just contain the platform native id, like "com.android.ebay" for Android or "12345689" for iOS.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.mobile_app_asset.app_store
Field description	Required. The application store that distributes this specific app.
Category	`ATTRIBUTE`
Data Type	`ENUM APPLE_APP_STORE GOOGLE_APP_STORE UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.MobileAppVendorEnum.MobileAppVendor`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.name
Field description	Optional name of the asset.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.page_feed_asset.labels
Field description	Labels used to group the page urls.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	True

asset.page_feed_asset.page_url
Field description	The webpage that advertisers want to target.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.resource_name
Field description	The resource name of the asset. Asset resource names have the form: `customers/{customer_id}/assets/{asset_id}`
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

asset.sitelink_asset.ad_schedule_targets
Field description	List 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.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.searchads360.v0.common.AdScheduleInfo`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

asset.sitelink_asset.description1
Field description	First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.sitelink_asset.description2
Field description	Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.sitelink_asset.end_date
Field description	Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.sitelink_asset.link_text
Field description	URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.sitelink_asset.mobile_preferred
Field description	Whether the preference is for the sitelink asset to be displayed on mobile devices. Applies to Microsoft Ads.
Category	`ATTRIBUTE`
Data Type	`BOOLEAN`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.sitelink_asset.start_date
Field description	Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.sitelink_asset.tracking_id
Field description	ID used for tracking clicks for the sitelink asset. This is a Yahoo! Japan only field.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.sitelink_asset.use_searcher_time_zone
Field description	Whether to show the sitelink asset in search user's time zone. Applies to Microsoft Ads.
Category	`ATTRIBUTE`
Data Type	`BOOLEAN`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.status
Field description	The status of the asset.
Category	`ATTRIBUTE`
Data Type	`ENUM ARCHIVED ENABLED PENDING_SYSTEM_GENERATED REMOVED UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.AssetStatusEnum.AssetStatus`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.text_asset.text
Field description	Text content of the text asset.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.tracking_url_template
Field description	URL template for constructing a tracking URL.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.type
Field description	Type of the asset.
Category	`ATTRIBUTE`
Data Type	`ENUM BOOK_ON_GOOGLE CALL CALLOUT CALL_TO_ACTION DISCOVERY_CAROUSEL_CARD DYNAMIC_CUSTOM DYNAMIC_EDUCATION DYNAMIC_FLIGHTS DYNAMIC_HOTELS_AND_RENTALS DYNAMIC_JOBS DYNAMIC_LOCAL DYNAMIC_REAL_ESTATE DYNAMIC_TRAVEL HOTEL_CALLOUT HOTEL_PROPERTY IMAGE LEAD_FORM LOCATION MEDIA_BUNDLE MOBILE_APP PAGE_FEED PRICE PROMOTION SITELINK STRUCTURED_SNIPPET TEXT UNKNOWN UNSPECIFIED YOUTUBE_VIDEO`
Type URL	`google.ads.searchads360.v0.enums.AssetTypeEnum.AssetType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.youtube_video_asset.youtube_video_id
Field description	YouTube video id. This is the 11 character string value used in the YouTube video URL.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset.youtube_video_asset.youtube_video_title
Field description	YouTube video title.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

asset

asset.call_asset.ad_schedule_targets

asset.call_asset.call_conversion_action

asset.call_asset.call_conversion_reporting_state

asset.call_asset.call_only

asset.call_asset.call_tracking_enabled

asset.call_asset.country_code

asset.call_asset.end_date

asset.call_asset.phone_number

asset.call_asset.start_date

asset.call_asset.use_searcher_time_zone

asset.call_to_action_asset.call_to_action

asset.callout_asset.ad_schedule_targets

asset.callout_asset.callout_text

asset.callout_asset.end_date

asset.callout_asset.start_date

asset.callout_asset.use_searcher_time_zone

asset.creation_time

asset.engine_status

asset.final_urls

asset.id

asset.image_asset.file_size

asset.image_asset.full_size.height_pixels

asset.image_asset.full_size.url

asset.image_asset.full_size.width_pixels

asset.image_asset.mime_type

asset.last_modified_time

asset.location_asset.business_profile_locations

asset.location_asset.location_ownership_type

asset.location_asset.place_id

asset.mobile_app_asset.app_id

asset.mobile_app_asset.app_store

asset.name

asset.page_feed_asset.labels

asset.page_feed_asset.page_url

asset.resource_name

asset.sitelink_asset.ad_schedule_targets

asset.sitelink_asset.description1

asset.sitelink_asset.description2

asset.sitelink_asset.end_date

asset.sitelink_asset.link_text

asset.sitelink_asset.mobile_preferred

asset.sitelink_asset.start_date

asset.sitelink_asset.tracking_id

asset.sitelink_asset.use_searcher_time_zone

asset.status

asset.text_asset.text

asset.tracking_url_template

asset.type

asset.youtube_video_asset.youtube_video_id

asset.youtube_video_asset.youtube_video_title