ad.added_by_google_ads |
| Field description | Output only. Indicates if this ad was automatically added by Google Ads and not by a user. For example, this could happen when ads are automatically created as suggestions for new ads based on knowledge of how existing ads are performing. |
| Category | ATTRIBUTE |
| Data Type | BOOLEAN |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.app_ad.descriptions |
| Field description | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.app_ad.headlines |
| Field description | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
|
| Field description | List of media bundle assets that may be used with the ad. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdMediaBundleAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
|
| Field description | The Asset resource name of this media bundle. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.app_ad.images |
| Field description | List of image assets that may be displayed with the ad. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdImageAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.app_ad.images.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.app_ad.mandatory_ad_text |
| Field description | Mandatory ad text. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
ad.app_ad.youtube_videos |
| Field description | List of YouTube video assets that may be displayed with the ad. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdVideoAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.app_ad.youtube_videos.asset |
| Field description | The Asset resource name of this video. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.app_engagement_ad.descriptions |
| Field description | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.app_engagement_ad.headlines |
| Field description | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.app_engagement_ad.images |
| Field description | List of image assets that may be displayed with the ad. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdImageAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.app_engagement_ad.images.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.app_engagement_ad.videos |
| Field description | List of video assets that may be displayed with the ad. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdVideoAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.app_engagement_ad.videos.asset |
| Field description | The Asset resource name of this video. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.app_pre_registration_ad.descriptions |
| Field description | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.app_pre_registration_ad.headlines |
| Field description | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.app_pre_registration_ad.images |
| Field description | List of image asset IDs whose images may be displayed with the ad. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdImageAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.app_pre_registration_ad.images.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.app_pre_registration_ad.youtube_videos |
| Field description | List of YouTube video asset IDs whose videos may be displayed with the ad. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdVideoAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.app_pre_registration_ad.youtube_videos.asset |
| Field description | The Asset resource name of this video. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.call_ad.business_name |
| Field description | The business name in the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.call_ad.call_tracked |
| Field description | Whether to enable call tracking for the creative. Enabling call tracking also enables call conversions. |
| Category | ATTRIBUTE |
| Data Type | BOOLEAN |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.call_ad.conversion_action |
| Field description | The conversion action to attribute a call conversion to. If not set a default conversion action is used. This field only has effect if call_tracked is set to true. Otherwise this field is ignored. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.call_ad.conversion_reporting_state |
| Field description | The call conversion behavior of this call ad. It can use its own call conversion setting, inherit the account level setting, or be disabled. |
| Category | ATTRIBUTE |
| Data Type |
ENUM
DISABLED UNKNOWN UNSPECIFIED USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION
|
| Type URL | google.ads.googleads.v17.enums.CallConversionReportingStateEnum.CallConversionReportingState |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.call_ad.country_code |
| Field description | The country code in the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.call_ad.description1 |
| Field description | The first line of the ad's description. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.call_ad.description2 |
| Field description | The second line of the ad's description. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.call_ad.disable_call_conversion |
| Field description | Whether to disable call conversion for the creative. If set to true, disables call conversions even when call_tracked is true. If call_tracked is false, this field is ignored. |
| Category | ATTRIBUTE |
| Data Type | BOOLEAN |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.call_ad.headline1 |
| Field description | First headline in the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.call_ad.headline2 |
| Field description | Second headline in the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.call_ad.path1 |
| Field description | First part of text that can be appended to the URL in the ad. Optional. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.call_ad.path2 |
| Field description | Second part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set. Optional. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.call_ad.phone_number |
| Field description | The phone number in the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.call_ad.phone_number_verification_url |
| Field description | The URL to be used for phone number verification. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.demand_gen_carousel_ad.business_name |
| Field description | Required. The Advertiser/brand name. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.demand_gen_carousel_ad.call_to_action_text |
| Field description | Call to action text. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.demand_gen_carousel_ad.carousel_cards |
| Field description | Required. Carousel cards that will display with the ad. Min 2 max 10. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdDemandGenCarouselCardAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.demand_gen_carousel_ad.carousel_cards.asset |
| Field description | The Asset resource name of this discovery carousel card. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_carousel_ad.description |
| Field description | Required. The descriptive text of the ad. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_carousel_ad.headline |
| Field description | Required. Headline of the ad. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_carousel_ad.logo_image |
| Field description | Required. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdImageAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_carousel_ad.logo_image.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_multi_asset_ad.business_name |
| Field description | The Advertiser/brand name. Maximum display width is 25. Required. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.demand_gen_multi_asset_ad.call_to_action_text |
| Field description | Call to action text. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.demand_gen_multi_asset_ad.descriptions |
| Field description | The descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.demand_gen_multi_asset_ad.headlines |
| Field description | Headline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
|
| Field description | Boolean option that indicates if this ad must be served with lead form. |
| Category | ATTRIBUTE |
| Data Type | BOOLEAN |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.demand_gen_multi_asset_ad.logo_images |
| Field description | Logo image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). At least 1 and max 5 logo images can be specified. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdImageAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.demand_gen_multi_asset_ad.logo_images.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_multi_asset_ad.marketing_images |
| Field description | Marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). Required if square_marketing_images is not present. Combined with square_marketing_images and portrait_marketing_images the maximum is 20. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdImageAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.demand_gen_multi_asset_ad.marketing_images.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_multi_asset_ad.portrait_marketing_images |
| Field description | Portrait marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 480x600 and the aspect ratio must be 4:5 (+-1%). Combined with marketing_images and square_marketing_images the maximum is 20. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdImageAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.demand_gen_multi_asset_ad.portrait_marketing_images.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_multi_asset_ad.square_marketing_images |
| Field description | Square marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). Required if marketing_images is not present. Combined with marketing_images and portrait_marketing_images the maximum is 20. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdImageAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.demand_gen_multi_asset_ad.square_marketing_images.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_product_ad.breadcrumb1 |
| Field description | First part of text that appears in the ad with the displayed URL. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.demand_gen_product_ad.breadcrumb2 |
| Field description | Second part of text that appears in the ad with the displayed URL. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.demand_gen_product_ad.business_name |
| Field description | Required. The advertiser/brand name. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_product_ad.call_to_action |
| Field description | Asset of type CallToActionAsset used for the "Call To Action" button. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdCallToActionAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_product_ad.call_to_action.asset |
| Field description | The Asset resource name of this call to action asset. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_product_ad.description |
| Field description | Required. Text asset used for the description. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_product_ad.headline |
| Field description | Required. Text asset used for the short headline. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_product_ad.logo_image |
| Field description | Required. Logo image to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdImageAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_product_ad.logo_image.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_video_responsive_ad.breadcrumb1 |
| Field description | First part of text that appears in the ad with the displayed URL. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.demand_gen_video_responsive_ad.breadcrumb2 |
| Field description | Second part of text that appears in the ad with the displayed URL. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.demand_gen_video_responsive_ad.business_name |
| Field description | Required. The advertiser/brand name. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_video_responsive_ad.call_to_actions |
| Field description | Assets of type CallToActionAsset used for the "Call To Action" button. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdCallToActionAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.demand_gen_video_responsive_ad.call_to_actions.asset |
| Field description | The Asset resource name of this call to action asset. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_video_responsive_ad.descriptions |
| Field description | List of text assets used for the description. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.demand_gen_video_responsive_ad.headlines |
| Field description | List of text assets used for the short headline. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.demand_gen_video_responsive_ad.logo_images |
| Field description | Logo image to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdImageAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.demand_gen_video_responsive_ad.logo_images.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.demand_gen_video_responsive_ad.long_headlines |
| Field description | List of text assets used for the long headline. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.demand_gen_video_responsive_ad.videos |
| Field description | List of YouTube video assets used for the ad. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdVideoAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.demand_gen_video_responsive_ad.videos.asset |
| Field description | The Asset resource name of this video. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.device_preference |
| Field description | The device preference for the ad. You can only specify a preference for mobile devices. When this preference is set the ad will be preferred over other ads when being displayed on a mobile device. The ad can still be displayed on other device types, for example, if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types. |
| Category | ATTRIBUTE |
| Data Type |
ENUM
CONNECTED_TV DESKTOP MOBILE OTHER TABLET UNKNOWN UNSPECIFIED
|
| Type URL | google.ads.googleads.v17.enums.DeviceEnum.Device |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.display_upload_ad.display_upload_product_type |
| Field description | The product type of this ad. See comments on the enum for details. |
| Category | ATTRIBUTE |
| Data Type |
ENUM
DYNAMIC_HTML5_CUSTOM_AD DYNAMIC_HTML5_EDUCATION_AD DYNAMIC_HTML5_FLIGHT_AD DYNAMIC_HTML5_HOTEL_AD DYNAMIC_HTML5_HOTEL_RENTAL_AD DYNAMIC_HTML5_JOB_AD DYNAMIC_HTML5_LOCAL_AD DYNAMIC_HTML5_REAL_ESTATE_AD DYNAMIC_HTML5_TRAVEL_AD HTML5_UPLOAD_AD UNKNOWN UNSPECIFIED
|
| Type URL | google.ads.googleads.v17.enums.DisplayUploadProductTypeEnum.DisplayUploadProductType |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | A media bundle asset to be used in the ad. For information about the media bundle for HTML5_UPLOAD_AD, see https://support.google.com/google-ads/answer/1722096 Media bundles that are part of dynamic product types use a special format that needs to be created through the Google Web Designer. See https://support.google.com/webdesigner/answer/7543898 for more information. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdMediaBundleAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
|
| Field description | The Asset resource name of this media bundle. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.display_url |
| Field description | The URL that appears in the ad description for some ad formats. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.expanded_dynamic_search_ad.description |
| Field description | The description of the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.expanded_dynamic_search_ad.description2 |
| Field description | The second description of the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.expanded_text_ad.description |
| Field description | The description of the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.expanded_text_ad.description2 |
| Field description | The second description of the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.expanded_text_ad.headline_part1 |
| Field description | The first part of the ad's headline. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.expanded_text_ad.headline_part2 |
| Field description | The second part of the ad's headline. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.expanded_text_ad.headline_part3 |
| Field description | The third part of the ad's headline. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.expanded_text_ad.path1 |
| Field description | The text that can appear alongside the ad's displayed URL. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.expanded_text_ad.path2 |
| Field description | Additional text that can appear alongside the ad's displayed URL. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.final_app_urls |
| Field description | A list of final app URLs that will be used on mobile if the user has the specific app installed. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.FinalAppUrl |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.final_mobile_urls |
| Field description | The list of possible final mobile URLs after all cross-domain redirects for the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.final_url_suffix |
| Field description | The suffix to use when constructing a final URL. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.final_urls |
| Field description | The list of possible final URLs after all cross-domain redirects for the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.hotel_ad |
| Field description | Details pertaining to a hotel ad. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.HotelAdInfo |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
ad.id |
| Field description | Output only. The ID of the ad. |
| Category | ATTRIBUTE |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.image_ad.image_asset.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.image_ad.image_url |
| Field description | URL of the full size image. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.image_ad.mime_type |
| Field description | The mime type of the image. |
| 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.googleads.v17.enums.MimeTypeEnum.MimeType |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.image_ad.name |
| Field description | The name of the image. If the image was created from a MediaFile, this is the MediaFile's name. If the image was created from bytes, this is empty. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.image_ad.pixel_height |
| Field description | Height in pixels of the full size image. |
| Category | ATTRIBUTE |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.image_ad.pixel_width |
| Field description | Width in pixels of the full size image. |
| Category | ATTRIBUTE |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.image_ad.preview_image_url |
| Field description | URL of the preview size image. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.image_ad.preview_pixel_height |
| Field description | Height in pixels of the preview size image. |
| Category | ATTRIBUTE |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.image_ad.preview_pixel_width |
| Field description | Width in pixels of the preview size image. |
| Category | ATTRIBUTE |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.legacy_app_install_ad |
| Field description | Immutable. Details pertaining to a legacy app install ad. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.LegacyAppInstallAdInfo |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
ad.legacy_responsive_display_ad.accent_color |
| Field description | The accent color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.legacy_responsive_display_ad.allow_flexible_color |
| Field description | Advertiser's consent to allow flexible color. When true, the ad may be served with different color if necessary. When false, the ad will be served with the specified colors or a neutral color. The default value is true. Must be true if main_color and accent_color are not set. |
| Category | ATTRIBUTE |
| Data Type | BOOLEAN |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.legacy_responsive_display_ad.business_name |
| Field description | The business name in the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.legacy_responsive_display_ad.call_to_action_text |
| Field description | The call-to-action text for the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.legacy_responsive_display_ad.description |
| Field description | The description of the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Specifies which format the ad will be served in. Default is ALL_FORMATS. |
| Category | ATTRIBUTE |
| Data Type |
ENUM
ALL_FORMATS NATIVE NON_NATIVE UNKNOWN UNSPECIFIED
|
| Type URL | google.ads.googleads.v17.enums.DisplayAdFormatSettingEnum.DisplayAdFormatSetting |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.legacy_responsive_display_ad.logo_image |
| Field description | The MediaFile resource name of the logo image used in the ad. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.legacy_responsive_display_ad.long_headline |
| Field description | The long version of the ad's headline. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.legacy_responsive_display_ad.main_color |
| Field description | The main color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.legacy_responsive_display_ad.marketing_image |
| Field description | The MediaFile resource name of the marketing image used in the ad. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.legacy_responsive_display_ad.price_prefix |
| Field description | Prefix before price. For example, 'as low as'. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.legacy_responsive_display_ad.promo_text |
| Field description | Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.legacy_responsive_display_ad.short_headline |
| Field description | The short version of the ad's headline. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.legacy_responsive_display_ad.square_logo_image |
| Field description | The MediaFile resource name of the square logo image used in the ad. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.legacy_responsive_display_ad.square_marketing_image |
| Field description | The MediaFile resource name of the square marketing image used in the ad. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.local_ad.call_to_actions |
| Field description | List of text assets for call-to-actions. When the ad serves the call-to-actions will be selected from this list. At least 1 and at most 5 call-to-actions must be specified. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.local_ad.descriptions |
| Field description | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. At least 1 and at most 5 descriptions must be specified. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.local_ad.headlines |
| Field description | List of text assets for headlines. When the ad serves the headlines will be selected from this list. At least 1 and at most 5 headlines must be specified. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.local_ad.logo_images |
| Field description | List of logo image assets that may be displayed with the ad. The images must be 128x128 pixels and not larger than 120KB. At least 1 and at most 5 image assets must be specified. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdImageAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.local_ad.logo_images.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.local_ad.marketing_images |
| Field description | List of marketing image assets that may be displayed with the ad. The images must be 314x600 pixels or 320x320 pixels. At least 1 and at most 20 image assets must be specified. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdImageAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.local_ad.marketing_images.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.local_ad.path1 |
| Field description | First part of optional text that can be appended to the URL in the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.local_ad.path2 |
| Field description | Second part of optional text that can be appended to the URL in the ad. This field can only be set when path1 is also set. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.local_ad.videos |
| Field description | List of YouTube video assets that may be displayed with the ad. At least 1 and at most 20 video assets must be specified. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdVideoAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.local_ad.videos.asset |
| Field description | The Asset resource name of this video. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.name |
| Field description | Immutable. The name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad. The name field is currently only supported for DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.resource_name |
| Field description | Immutable. The resource name of the ad. Ad resource names have the form: customers/{customer_id}/ads/{ad_id} |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
ad.responsive_display_ad.accent_color |
| Field description | The accent color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.responsive_display_ad.allow_flexible_color |
| Field description | Advertiser's consent to allow flexible color. When true, the ad may be served with different color if necessary. When false, the ad will be served with the specified colors or a neutral color. The default value is true. Must be true if main_color and accent_color are not set. |
| Category | ATTRIBUTE |
| Data Type | BOOLEAN |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.responsive_display_ad.business_name |
| Field description | The advertiser/brand name. Maximum display width is 25. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.responsive_display_ad.call_to_action_text |
| Field description | The call-to-action text for the ad. Maximum display width is 30. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.responsive_display_ad.control_spec.enable_asset_enhancements |
| Field description | Whether the advertiser has opted into the asset enhancements feature. |
| Category | ATTRIBUTE |
| Data Type | BOOLEAN |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.responsive_display_ad.control_spec.enable_autogen_video |
| Field description | Whether the advertiser has opted into auto-gen video feature. |
| Category | ATTRIBUTE |
| Data Type | BOOLEAN |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.responsive_display_ad.descriptions |
| Field description | Descriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
|
| Field description | Specifies which format the ad will be served in. Default is ALL_FORMATS. |
| Category | ATTRIBUTE |
| Data Type |
ENUM
ALL_FORMATS NATIVE NON_NATIVE UNKNOWN UNSPECIFIED
|
| Type URL | google.ads.googleads.v17.enums.DisplayAdFormatSettingEnum.DisplayAdFormatSetting |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.responsive_display_ad.headlines |
| Field description | Short format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.responsive_display_ad.logo_images |
| Field description | Logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 512x128 and the aspect ratio must be 4:1 (+-1%). Combined with square_logo_images, the maximum is 5. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdImageAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.responsive_display_ad.logo_images.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.responsive_display_ad.long_headline |
| Field description | A required long format headline. The maximum length is 90 characters. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
ad.responsive_display_ad.main_color |
| Field description | The main color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.responsive_display_ad.marketing_images |
| Field description | Marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). At least one marketing_image is required. Combined with square_marketing_images, the maximum is 15. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdImageAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.responsive_display_ad.marketing_images.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.responsive_display_ad.price_prefix |
| Field description | Prefix before price. For example, 'as low as'. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.responsive_display_ad.promo_text |
| Field description | Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.responsive_display_ad.square_logo_images |
| Field description | Square logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). Combined with logo_images, the maximum is 5. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdImageAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.responsive_display_ad.square_logo_images.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.responsive_display_ad.square_marketing_images |
| Field description | Square marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). At least one square marketing_image is required. Combined with marketing_images, the maximum is 15. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdImageAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.responsive_display_ad.square_marketing_images.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.responsive_display_ad.youtube_videos |
| Field description | Optional YouTube videos for the ad. A maximum of 5 videos can be specified. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdVideoAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.responsive_display_ad.youtube_videos.asset |
| Field description | The Asset resource name of this video. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.responsive_search_ad.descriptions |
| Field description | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.responsive_search_ad.headlines |
| Field description | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.responsive_search_ad.path1 |
| Field description | First part of text that can be appended to the URL in the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.responsive_search_ad.path2 |
| Field description | Second part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Headline of the ad. This field is required. Allowed length is between 25 and 45 characters. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Details pertaining to a Shopping product ad. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.ShoppingProductAdInfo |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
|
| Field description | Details pertaining to a Smart Shopping ad. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.ShoppingSmartAdInfo |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
ad.smart_campaign_ad.descriptions |
| Field description | List of text assets, each of which corresponds to a description when the ad serves. This list consists of a minimum of 2 and up to 4 text assets. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.smart_campaign_ad.headlines |
| Field description | List of text assets, each of which corresponds to a headline when the ad serves. This list consists of a minimum of 3 and up to 15 text assets. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.system_managed_resource_source |
| Field description | Output only. If this ad is system managed, then this field will indicate the source. This field is read-only. |
| Category | ATTRIBUTE |
| Data Type |
ENUM
AD_VARIATIONS UNKNOWN UNSPECIFIED
|
| Type URL | google.ads.googleads.v17.enums.SystemManagedResourceSourceEnum.SystemManagedResourceSource |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.tracking_url_template |
| Field description | The URL template for constructing a tracking URL. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.travel_ad |
| Field description | Details pertaining to a travel ad. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.TravelAdInfo |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
ad.type |
| Field description | Output only. The type of ad. |
| Category | ATTRIBUTE |
| Data Type |
ENUM
APP_AD APP_ENGAGEMENT_AD APP_PRE_REGISTRATION_AD CALL_AD DEMAND_GEN_CAROUSEL_AD DEMAND_GEN_MULTI_ASSET_AD DEMAND_GEN_PRODUCT_AD DEMAND_GEN_VIDEO_RESPONSIVE_AD DYNAMIC_HTML5_AD EXPANDED_DYNAMIC_SEARCH_AD EXPANDED_TEXT_AD HOTEL_AD HTML5_UPLOAD_AD IMAGE_AD IN_FEED_VIDEO_AD LEGACY_APP_INSTALL_AD LEGACY_RESPONSIVE_DISPLAY_AD LOCAL_AD RESPONSIVE_DISPLAY_AD RESPONSIVE_SEARCH_AD SHOPPING_COMPARISON_LISTING_AD SHOPPING_PRODUCT_AD SHOPPING_SMART_AD SMART_CAMPAIGN_AD TEXT_AD TRAVEL_AD UNKNOWN UNSPECIFIED VIDEO_AD VIDEO_BUMPER_AD VIDEO_NON_SKIPPABLE_IN_STREAM_AD VIDEO_OUTSTREAM_AD VIDEO_RESPONSIVE_AD VIDEO_TRUEVIEW_IN_STREAM_AD
|
| Type URL | google.ads.googleads.v17.enums.AdTypeEnum.AdType |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.url_collections |
| Field description | Additional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.UrlCollection |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.url_custom_parameters |
| Field description | The list of mappings that can be used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. For mutates, use url custom parameter operations. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.CustomParameter |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
|
| Field description | Label on the "Call To Action" button taking the user to the video ad's final URL. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.video_ad.bumper.action_headline |
| Field description | Additional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.video_ad.bumper.companion_banner.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.video_ad.in_feed.description1 |
| Field description | First text line for the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.video_ad.in_feed.description2 |
| Field description | Second text line for the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.video_ad.in_feed.headline |
| Field description | The headline of the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.video_ad.in_feed.thumbnail |
| Field description | Video thumbnail image to use. |
| Category | ATTRIBUTE |
| Data Type |
ENUM
DEFAULT_THUMBNAIL THUMBNAIL_1 THUMBNAIL_2 THUMBNAIL_3 UNKNOWN UNSPECIFIED
|
| Type URL | google.ads.googleads.v17.enums.VideoThumbnailEnum.VideoThumbnail |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Label on the CTA (call-to-action) button taking the user to the video ad's final URL. Required for TrueView for action campaigns, optional otherwise. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.video_ad.in_stream.action_headline |
| Field description | Additional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.video_ad.in_stream.companion_banner.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Label on the "Call To Action" button taking the user to the video ad's final URL. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.video_ad.non_skippable.action_headline |
| Field description | Additional text displayed with the "Call To Action" button to give context and encourage clicking on the button. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.video_ad.non_skippable.companion_banner.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.video_ad.out_stream.description |
| Field description | The description line. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.video_ad.out_stream.headline |
| Field description | The headline of the ad. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.video_ad.video.asset |
| Field description | The Asset resource name of this video. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.video_responsive_ad.breadcrumb1 |
| Field description | First part of text that appears in the ad with the displayed URL. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.video_responsive_ad.breadcrumb2 |
| Field description | Second part of text that appears in the ad with the displayed URL. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
ad.video_responsive_ad.call_to_actions |
| Field description | List of text assets used for the button, for example, the "Call To Action" button. Currently, only a single value for the button is supported. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.video_responsive_ad.companion_banners |
| Field description | List of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdImageAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.video_responsive_ad.companion_banners.asset |
| Field description | The Asset resource name of this image. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
ad.video_responsive_ad.descriptions |
| Field description | List of text assets used for the description. Currently, only a single value for the description is supported. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.video_responsive_ad.headlines |
| Field description | List of text assets used for the short headline. Currently, only a single value for the short headline is supported. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.video_responsive_ad.long_headlines |
| Field description | List of text assets used for the long headline. Currently, only a single value for the long headline is supported. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdTextAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.video_responsive_ad.videos |
| Field description | List of YouTube video assets used for the ad. Currently, only a single value for the YouTube video asset is supported. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v17.common.AdVideoAsset |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
ad.video_responsive_ad.videos.asset |
| Field description | The Asset resource name of this video. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | False |
| Sortable | False |
| Repeated | False |
|
