type AdUnitSize (v202502)
Stay organized with collections
Save and categorize content based on your preferences.
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/v202502
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.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-06 UTC.
[null,null,["Last updated 2025-08-06 UTC."],[],["`AdUnitSize` defines the dimensions and environment of an ad within an ad unit. It includes `size` (creative dimensions), `environmentType` (e.g., BROWSER, VIDEO_PLAYER), and optional `companions` (related ads for video players). The `fullDisplayString` provides a complete size representation. If the `isAudio` field is true then the `size` is forced to `1x1` and `EnvironmentType` is set to `VIDEO_PLAYER`.\n"],null,["# type AdUnitSize (v202502)\n\n**Service** \n[InventoryService](/ad-manager/api/reference/v202502/InventoryService.AdUnitSize) **SuggestedAdUnitService** **Dependencies** \n[AdUnitSize](/ad-manager/api/reference/v202502/SuggestedAdUnitService.AdUnitSize) [SuggestedAdUnit](/ad-manager/api/reference/v202502/SuggestedAdUnitService.SuggestedAdUnit) \n▼\n**AdUnitSize**\n\nAn `AdUnitSize` represents the size of an ad in an ad unit. This also represents the\nenvironment and companions of a particular ad in an ad unit. In most cases, it is a simple size\nwith just a width and a height (sometimes representing an aspect ratio).\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202502`\n\n| Field ----- ||\n|-------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `size` | ` `[Size](/ad-manager/api/reference/v202502/SuggestedAdUnitService.Size)` ` The permissible creative size that can be served inside this ad unit. |\n| ### `environmentType` | ` `[EnvironmentType](/ad-manager/api/reference/v202502/SuggestedAdUnitService.EnvironmentType)` ` The environment type of the ad unit size. The default value is [EnvironmentType.BROWSER](/ad-manager/api/reference/v202502/SuggestedAdUnitService.EnvironmentType#BROWSER). *** ** * ** *** **Enumerations** `BROWSER` : A regular web browser. `VIDEO_PLAYER` : Video players. \u003cbr /\u003e |\n| ### `companions` | ` `[AdUnitSize](/ad-manager/api/reference/v202502/SuggestedAdUnitService.AdUnitSize)`[]` The companions for this ad unit size. Companions are only valid if the environment is [EnvironmentType.VIDEO_PLAYER](/ad-manager/api/reference/v202502/SuggestedAdUnitService.EnvironmentType#VIDEO_PLAYER). If the environment is [EnvironmentType.BROWSER](/ad-manager/api/reference/v202502/SuggestedAdUnitService.EnvironmentType#BROWSER) including companions results in an error. |\n| ### `fullDisplayString` | ` `xsd:`string` The full (including companion sizes, if applicable) display string of the size, e.g. `\"300x250\"` or `\"300x250v (180x150)\"` |\n| ### `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](/ad-manager/api/reference/v202502/SuggestedAdUnitService.EnvironmentType#VIDEO_PLAYER) regardless of user input. |"]]