ResponsiveDisplayAdInfo

  • Responsive display ads require specific marketing images, square marketing images, and optionally logo images and square logo images, each with minimum size and aspect ratio requirements.

  • Text assets like headlines and descriptions have maximum lengths and require a certain number of entries, including a required long headline.

  • Optional components include YouTube videos, format settings, control specifications, and details like business name, colors, flexible color allowance, call-to-action text, price prefix, and promo text.

A responsive display ad.

Proto definition

Fields

accent_color

string

The accent color of the ad in hexadecimal, for example, #ffffff for white. If one ofmain_color andaccent_color is set, the other is required as well.

allow_flexible_color

bool

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 istrue. Must be true ifmain_color andaccent_color are not set.

business_name

string

The advertiser/brand name. Maximum display width is 25.

call_to_action_text

string

The call-to-action text for the ad. Maximum display width is 30.

control_spec

ResponsiveDisplayAdControlSpec

Specification for various creative controls.

descriptions[]

AdTextAsset

Descriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified.

format_setting

DisplayAdFormatSetting

Specifies which format the ad will be served in. Default is ALL_FORMATS.

headlines[]

AdTextAsset

Short format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified.

logo_images[]

AdImageAsset

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 withsquare_logo_images, the maximum is 5.

long_headline

AdTextAsset

A required long format headline. The maximum length is 90 characters.

main_color

string

The main color of the ad in hexadecimal, for example, #ffffff for white. If one ofmain_color andaccent_color is set, the other is required as well.

marketing_images[]

AdImageAsset

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 onemarketing_image is required. Combined withsquare_marketing_images, the maximum is 15.

price_prefix

string

Prefix before price. For example, 'as low as'.

promo_text

string

Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.

square_logo_images[]

AdImageAsset

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 withlogo_images, the maximum is 5.

square_marketing_images[]

AdImageAsset

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 squaremarketing_image is required. Combined withmarketing_images, the maximum is 15.

youtube_videos[]

AdVideoAsset

Optional YouTube videos for the ad. A maximum of 5 videos can be specified.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-12 UTC.