type AdUnitSize (v202508)

AI-generated Key Takeaways

• An AdUnitSize represents the size, environment, and companions of an ad within an ad unit.

• It typically consists of a simple size with width and height, sometimes representing an aspect ratio.

• Fields within AdUnitSize include size, environmentType, companions, fullDisplayString, and isAudio.

• Companions are only valid for ad unit sizes with the VIDEO_PLAYER environment type.

• An ad unit size can be designated as audio, which sets its size to 1x1 and environment to VIDEO_PLAYER.

Service

InventoryService SuggestedAdUnitService

Dependencies

AdUnit AdUnitSize getAdUnitSizesByStatement()

▼

AdUnitSize

An AdUnitSize represents the size of an ad in an ad unit. This also represents the environment and companions of a particular ad in an ad unit. In most cases, it is a simple size with just a width and a height (sometimes representing an aspect ratio).

---

Namespace

https://www.google.com/apis/ads/publisher/v202508

Field
size	Size The permissible creative size that can be served inside this ad unit.
environmentType	EnvironmentType The environment type of the ad unit size. The default value is EnvironmentType.BROWSER. Enumerations BROWSER A regular web browser. VIDEO_PLAYER Video players.
companions	AdUnitSize[] The companions for this ad unit size. Companions are only valid if the environment is EnvironmentType.VIDEO_PLAYER. If the environment is EnvironmentType.BROWSER including companions results in an error.
fullDisplayString	xsd:string The full (including companion sizes, if applicable) display string of the size, e.g. "300x250" or "300x250v (180x150)"
isAudio	xsd:boolean Whether the inventory size is audio. If set to true, Size will be set to "1x1" and EnvironmentType will be set to EnvironmentType.VIDEO_PLAYER regardless of user input.