# REST Resource: accounts.adUnits

- [Resource: AdUnit](https://developers.google.com/admob/api/reference/rest/v1beta/accounts.adUnits#AdUnit)
  - [JSON representation](https://developers.google.com/admob/api/reference/rest/v1beta/accounts.adUnits#AdUnit.SCHEMA_REPRESENTATION)
- [RewardSettings](https://developers.google.com/admob/api/reference/rest/v1beta/accounts.adUnits#RewardSettings)
  - [JSON representation](https://developers.google.com/admob/api/reference/rest/v1beta/accounts.adUnits#RewardSettings.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/admob/api/reference/rest/v1beta/accounts.adUnits#METHODS_SUMMARY)

## Resource: AdUnit

Describes an AdMob ad unit.

| JSON representation |
|---|
| ``` { "name": string, "adUnitId": string, "appId": string, "displayName": string, "adFormat": string, "adTypes": [ string ], "rewardSettings": { object (`https://developers.google.com/admob/api/reference/rest/v1beta/accounts.adUnits#RewardSettings`) } } ``` |

| Fields ||
|---|---|
| `name` | `string` Resource name for this ad unit. Format is accounts/{publisherId}/adUnits/{ad_unit_id_fragment} Example: accounts/pub-9876543210987654/adUnits/0123456789 |
| `adUnitId` | `string` The externally visible ID of the ad unit which can be used to integrate with the AdMob SDK. This is a read only property. Example: ca-app-pub-9876543210987654/0123456789 |
| `appId` | `string` The externally visible ID of the app this ad unit is associated with. Example: ca-app-pub-9876543210987654\~0123456789 |
| `displayName` | `string` The display name of the ad unit as shown in the AdMob UI, which is provided by the user. The maximum length allowed is 80 characters. |
| `adFormat` | `string` AdFormat of the ad unit. Possible values are as follows: "APP_OPEN" - App Open ad format. "BANNER" - Banner ad format. "BANNER_INTERSTITIAL" - Legacy format that can be used as either banner or interstitial. This format can no longer be created but can be targeted by mediation groups. "INTERSTITIAL" - A full screen ad. Supported ad types are "RICH_MEDIA" and "VIDEO". "NATIVE" - Native ad format. "REWARDED" - An ad that, once viewed, gets a callback verifying the view so that a reward can be given to the user. Supported ad types are "RICH_MEDIA" (interactive) and video where video can not be excluded. "REWARDED_INTERSTITIAL" - Rewarded Interstitial ad format. Only supports video ad type. See <https://support.google.com/admob/answer/9884467>. |
| `adTypes[]` | `string` Ad media type supported by this ad unit. Possible values as follows: "RICH_MEDIA" - Text, image, and other non-video media. "VIDEO" - Video media. |
| `rewardSettings` | ``object (`https://developers.google.com/admob/api/reference/rest/v1beta/accounts.adUnits#RewardSettings`)`` Optional. Settings for a rewarded ad unit. This can be set or unset only when the adFormat is "REWARDED". |

## RewardSettings

Settings for a rewarded ad unit.

| JSON representation |
|---|
| ``` { "unitAmount": string, "unitType": string } ``` |

| Fields ||
|---|---|
| `unitAmount` | `string (https://developers.google.com/discovery/v1/type-format format)` Reward amount for this ad unit. |
| `unitType` | `string` Reward item for this ad unit. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/admob/api/reference/rest/v1beta/accounts.adUnits/create` | Creates an ad unit under the specified AdMob account. |
| ### `https://developers.google.com/admob/api/reference/rest/v1beta/accounts.adUnits/list` | List the ad units under the specified AdMob account. |