REST Resource: accounts.adUnits
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Recurso: Bloco de anúncios
Descreve um bloco de anúncios da AdMob.
Representação JSON |
{
"name": string,
"adUnitId": string,
"appId": string,
"displayName": string,
"adFormat": string,
"adTypes": [
string
],
"rewardSettings": {
object (RewardSettings )
}
} |
Campos |
name |
string
Nome do recurso para este bloco de anúncios. O formato é accounts/{publisherId}/adUnits/{ad_unit_id_fragment} Exemplo: accounts/pub-9876543210987654/adUnits/0123456789
|
adUnitId |
string
O ID visível externamente do bloco de anúncios que pode ser usado na integração com o SDK da AdMob. Esta é uma propriedade somente leitura. Exemplo: ca-app-pub-9876543210987654/0123456789
|
appId |
string
O ID visível externamente do app ao qual este bloco de anúncios está associado. Exemplo: ca-app-pub-9876543210987654~0123456789
|
displayName |
string
O nome de exibição do bloco de anúncios, conforme mostrado na interface da AdMob e fornecida pelo usuário. O tamanho máximo permitido é de 80 caracteres.
|
adFormat |
string
Formato do anúncio do bloco de anúncios. Os possíveis valores são os seguintes: "APP_OPEN" - Formato do anúncio de abertura do app. "BANNER" - Formato de anúncio de banner. "BANNER_INTERSTITIAL" - Formato legado que pode ser usado como banner ou intersticial. Esse formato não pode mais ser criado, mas pode ser segmentado por grupos de mediação. "INTERSTITIAL" - Um anúncio de tela cheia. Os tipos de anúncios compatíveis são "RICH_MEDIA" e "VIDEO". "NATIVO" - Formato de anúncio nativo. "PREMIADO" - Um anúncio que, depois de visualizado, recebe uma chamada de retorno verificando a visualização para que um prêmio possa ser concedido ao usuário. Os tipos de anúncios compatíveis são "RICH_MEDIA" (interativo) e vídeo em que o vídeo não pode ser excluído. "REWARDED_INTERSTITIAL" - Formato de anúncio intersticial premiado. Compatível apenas com o tipo de anúncio em vídeo. Consulte https://support.google.com/admob/answer/9884467.
|
adTypes[] |
string
Tipo de mídia do anúncio compatível com este bloco de anúncios. Valores possíveis: "RICH_MEDIA" - Texto, imagem e outras mídias que não sejam vídeos. "VÍDEO" - Mídia em vídeo.
|
rewardSettings |
object (RewardSettings )
Opcional. Configurações de um bloco de anúncios premiado. Só é possível definir ou cancelar a definição quando o adFormat é "REWARDED".
|
RewardSettings
Configurações de um bloco de anúncios premiado.
Representação JSON |
{
"unitAmount": string,
"unitType": string
} |
Campos |
unitAmount |
string (int64 format)
Valor do prêmio deste bloco de anúncios.
|
unitType |
string
Item de prêmio para este bloco de anúncios.
|
Métodos |
|
Cria um bloco de anúncios na conta especificada da AdMob. |
|
Liste os blocos de anúncios na conta especificada da AdMob. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-21 UTC.
[null,null,["Última atualização 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. |"]]