REST Resource: accounts.adUnits
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Recurso: AdUnit
Describe una unidad de anuncios de AdMob.
Representación JSON |
{
"name": string,
"adUnitId": string,
"appId": string,
"displayName": string,
"adFormat": string,
"adTypes": [
string
],
"rewardSettings": {
object (RewardSettings )
}
} |
Campos |
name |
string
Es el nombre del recurso para esta unidad de anuncios. El formato es accounts/{publisherId}/adUnits/{ad_unit_id_fragment}. Ejemplo: accounts/pub-9876543210987654/adUnits/0123456789.
|
adUnitId |
string
Es el ID visible externamente de la unidad de anuncios que se puede utilizar para realizar la integración con el SDK de AdMob. Esta es una propiedad de solo lectura. Ejemplo: ca-app-pub-9876543210987654/0123456789
|
appId |
string
Es el ID visible externamente de la aplicación con la que está asociada esta unidad de anuncios. Ejemplo: ca-app-pub-9876543210987654~0123456789
|
displayName |
string
Indica el nombre visible de la unidad de anuncios como se muestra en la IU de AdMob que proporciona el usuario. La longitud máxima permitida es de 80 caracteres.
|
adFormat |
string
Formato del anuncio de la unidad de anuncios. Los valores posibles son los siguientes: “APP_OPEN” - Formato del anuncio de aplicación abierta. “BANNER” - Formato de anuncio de banner. “BANNER_INTERSTITIAL” - Formato heredado que se puede usar como banner o intersticial. Ya no se puede crear este formato, pero los grupos de mediación pueden segmentarse para él. “INTERSTIIAL” - Un anuncio de pantalla completa. Los tipos de anuncios admitidos son "RICH_MEDIA" y "VIDEO". "NATIVO" - Formato de anuncio nativo. “RECOMPENSA” - Un anuncio que, una vez visto, recibe una devolución de llamada en la que se verifica la vista para poder otorgar una recompensa al usuario. Los tipos de anuncios admitidos son "RICH_MEDIA" (interactivo) y los videos en los que no se pueden excluir videos “REWARDED_INTERSTITIAL” - Formato del anuncio intersticial recompensado. Solo es compatible con el tipo de anuncio de video. Consulta https://support.google.com/admob/answer/9884467.
|
adTypes[] |
string
Es el tipo de medio del anuncio compatible con esta unidad de anuncios. Estos son los valores posibles: “RICH_MEDIA” - Texto, imagen y otro contenido multimedia que no sea de video "VIDEO" - Contenido multimedia de video
|
rewardSettings |
object (RewardSettings )
Opcional. Configuración para una unidad de anuncios recompensados. Esto se puede configurar o no solo cuando el formato del anuncio es "REWARDED".
|
RewardSettings
Configuración para una unidad de anuncios recompensados.
Representación JSON |
{
"unitAmount": string,
"unitType": string
} |
Campos |
unitAmount |
string (int64 format)
Es el importe de la recompensa para esta unidad de anuncios.
|
unitType |
string
Elemento de recompensa para esta unidad de anuncios.
|
Métodos |
|
Crea una unidad de anuncios en la cuenta de AdMob especificada. |
|
Genera una lista de las unidades de anuncios en la cuenta de AdMob especificada. |
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-21 (UTC)
[null,null,["Última actualización: 2025-08-21 (UTC)"],[[["\u003cp\u003eThe AdUnit resource describes an AdMob ad unit, containing properties like name, ID, format, and reward settings.\u003c/p\u003e\n"],["\u003cp\u003eAdUnits support various ad formats, including banner, interstitial, rewarded, and native, each with specific properties and functionalities.\u003c/p\u003e\n"],["\u003cp\u003eRewardSettings, applicable to rewarded ad units, define the reward amount and type for users upon viewing an ad.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage AdUnits using the AdMob API to create new units and list existing ones under your account.\u003c/p\u003e\n"]]],["The core content details AdUnit and RewardSettings resources, including their JSON representations and fields. AdUnit describes an AdMob ad unit with properties like name, ID, app association, display name, format (e.g., banner, interstitial, rewarded), and supported ad types (e.g., rich media, video). RewardSettings defines settings for rewarded ad units, specifying the reward amount and item. Key methods are to create and list ad units under a given AdMob account.\n"],null,["# REST Resource: accounts.adUnits\n\n- [Resource: AdUnit](#AdUnit)\n - [JSON representation](#AdUnit.SCHEMA_REPRESENTATION)\n- [RewardSettings](#RewardSettings)\n - [JSON representation](#RewardSettings.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: AdUnit\n----------------\n\nDescribes an AdMob ad unit.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"adUnitId\": string, \"appId\": string, \"displayName\": string, \"adFormat\": string, \"adTypes\": [ string ], \"rewardSettings\": { object (/admob/api/reference/rest/v1beta/accounts.adUnits#RewardSettings) } } ``` |\n\n| Fields ||\n|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Resource name for this ad unit. Format is accounts/{publisherId}/adUnits/{ad_unit_id_fragment} Example: accounts/pub-9876543210987654/adUnits/0123456789 |\n| `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 |\n| `appId` | `string` The externally visible ID of the app this ad unit is associated with. Example: ca-app-pub-9876543210987654\\~0123456789 |\n| `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. |\n| `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 \u003chttps://support.google.com/admob/answer/9884467\u003e. |\n| `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. |\n| `rewardSettings` | `object (`[RewardSettings](/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\". |\n\nRewardSettings\n--------------\n\nSettings for a rewarded ad unit.\n\n| JSON representation |\n|------------------------------------------------------|\n| ``` { \"unitAmount\": string, \"unitType\": string } ``` |\n\n| Fields ||\n|--------------|---------------------------------------------------------------------------------------------------------------------|\n| `unitAmount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Reward amount for this ad unit. |\n| `unitType` | `string` Reward item for this ad unit. |\n\n| Methods ------- ||\n|------------------------------------------------------------------------|-------------------------------------------------------|\n| ### [create](/admob/api/reference/rest/v1beta/accounts.adUnits/create) | Creates an ad unit under the specified AdMob account. |\n| ### [list](/admob/api/reference/rest/v1beta/accounts.adUnits/list) | List the ad units under the specified AdMob account. |"]]