type AdUnitSize (v202408)
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/v202408
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."],[[["\u003cp\u003e\u003ccode\u003eAdUnitSize\u003c/code\u003e defines the dimensions of an ad within an ad unit, encompassing its width, height, and potential aspect ratio.\u003c/p\u003e\n"],["\u003cp\u003eIt also specifies the ad's environment (browser or video player) and any associated companion ads, which are only applicable to video player environments.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eAdUnitSize\u003c/code\u003e includes fields like \u003ccode\u003esize\u003c/code\u003e, \u003ccode\u003eenvironmentType\u003c/code\u003e, \u003ccode\u003ecompanions\u003c/code\u003e, \u003ccode\u003efullDisplayString\u003c/code\u003e, and \u003ccode\u003eisAudio\u003c/code\u003e to provide comprehensive details about the ad unit's size and characteristics.\u003c/p\u003e\n"],["\u003cp\u003eWhen \u003ccode\u003eisAudio\u003c/code\u003e is true, it signifies an audio inventory size with a default size of "1x1" and a video player environment.\u003c/p\u003e\n"]]],["`AdUnitSize` defines the dimensions and environment of an ad within an ad unit. It includes `size`, representing permissible creative dimensions, and `environmentType`, specifying whether it's a browser or video player. Video players can have `companions`, additional ad sizes. `fullDisplayString` provides a complete size description. The `isAudio` field indicates an audio ad, which forces a \"1x1\" size and video player environment.\n"],null,["# type AdUnitSize (v202408)\n\n**Service** \n[InventoryService](/ad-manager/api/reference/v202408/InventoryService.AdUnitSize) **SuggestedAdUnitService** **Dependencies** \n[AdUnitSize](/ad-manager/api/reference/v202408/SuggestedAdUnitService.AdUnitSize) [SuggestedAdUnit](/ad-manager/api/reference/v202408/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/v202408`\n\n| Field ----- ||\n|-------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `size` | ` `[Size](/ad-manager/api/reference/v202408/SuggestedAdUnitService.Size)` ` The permissible creative size that can be served inside this ad unit. |\n| ### `environmentType` | ` `[EnvironmentType](/ad-manager/api/reference/v202408/SuggestedAdUnitService.EnvironmentType)` ` The environment type of the ad unit size. The default value is [EnvironmentType.BROWSER](/ad-manager/api/reference/v202408/SuggestedAdUnitService.EnvironmentType#BROWSER). *** ** * ** *** **Enumerations** `BROWSER` : A regular web browser. `VIDEO_PLAYER` : Video players. \u003cbr /\u003e |\n| ### `companions` | ` `[AdUnitSize](/ad-manager/api/reference/v202408/SuggestedAdUnitService.AdUnitSize)`[]` The companions for this ad unit size. Companions are only valid if the environment is [EnvironmentType.VIDEO_PLAYER](/ad-manager/api/reference/v202408/SuggestedAdUnitService.EnvironmentType#VIDEO_PLAYER). If the environment is [EnvironmentType.BROWSER](/ad-manager/api/reference/v202408/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/v202408/SuggestedAdUnitService.EnvironmentType#VIDEO_PLAYER) regardless of user input. |"]]
