Retrieve responsive display ads

Page Summary

• Retrieve responsive display ads by calling GoogleAdsService.SearchStream and filtering by RESPONSIVE_DISPLAY_AD.

• The provided query selects various fields for responsive display ads including business name, descriptions, and headlines.

• The query filters results to only include ads of type RESPONSIVE_DISPLAY_AD from the ad_group_ad table.

To retrieve the responsive display ads you've created, call the GoogleAdsService.SearchStream method with a query that filters ad types to RESPONSIVE_DISPLAY_AD.

Query responsive display ads

The following query retrieves non-removed responsive display ads and their core asset fields:

SELECT
  ad_group.id,
  ad_group_ad.ad.id,
  ad_group_ad.ad.type,
  ad_group_ad.ad.final_urls,
  ad_group_ad.ad.responsive_display_ad.business_name,
  ad_group_ad.ad.responsive_display_ad.descriptions,
  ad_group_ad.ad.responsive_display_ad.headlines,
  ad_group_ad.ad.responsive_display_ad.long_headline,
  ad_group_ad.ad.responsive_display_ad.marketing_images,
  ad_group_ad.ad.responsive_display_ad.square_marketing_images,
  ad_group_ad.status
FROM ad_group_ad
WHERE ad_group_ad.ad.type = 'RESPONSIVE_DISPLAY_AD'
  AND ad_group_ad.status != 'REMOVED'

Note: Repeated image fields such as marketing_images and square_marketing_images return a list of AdImageAsset objects whose asset subfield contains an asset resource name (for example, customers/{customer_id}/assets/{asset_id}) rather than a raw image URL. To retrieve image URLs or metadata, query the asset resource (such as asset.image_asset.full_size.url, asset.image_asset.full_size.width_pixels, asset.image_asset.full_size.height_pixels, asset.image_asset.file_size, and asset.image_asset.mime_type) using those resource names.