Responsive Display Ad creation via Google Ads API does not support portrait (vertical) images

[Mauro Suhin]

Hello,

While integrating Responsive Display Ad creation through the Google Ads API using the PHP client library (v19), I noticed that there is no way to add portrait (also referred to as vertical) images when using the ResponsiveDisplayAdInfo entity (google.ads.googleads.v19.common.ResponsiveDisplayAdInfo).

In the Google Ads UI, there is both a recommendation and an option to add portrait images when creating a Responsive Display Ad. The official documentation also recommends including portrait images for better ad performance, although in the documentation these are referred to as “vertical” images:
https://support.google.com/google-ads/answer/9823397

However, in the generated PHP class for ResponsiveDisplayAdInfo, there is no field to provide portrait or vertical images. Only the following image types are currently supported:

• marketing_images (landscape, 1.91:1 aspect ratio)

• square_marketing_images (1:1 aspect ratio)

There is no equivalent field for portrait/vertical images (e.g., 4:5 aspect ratio). This limitation exists not only in v19 of the PHP SDK, but also appears to persist in later API versions.

For reference, here is the official API documentation for the ResponsiveDisplayAdInfo resource:
https://developers.google.com/google-ads/api/reference/rpc/v21/ResponsiveDisplayAdInfo

Question:
Is there a specific reason why portrait (vertical) image uploads are not supported in the ResponsiveDisplayAdInfo object, or is this an oversight/bug in the API?