REST Resource: accounts.adUnits
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Risorsa: unità pubblicitaria
Descrive un'unità pubblicitaria AdMob.
| Rappresentazione JSON |
{
"name": string,
"adUnitId": string,
"appId": string,
"displayName": string,
"adFormat": string,
"adTypes": [
string
],
"rewardSettings": {
object (RewardSettings)
}
} |
| Campi |
name |
string
Nome della risorsa per questa unità pubblicitaria. Il formato è accounts/{publisherId}/adUnits/{ad_unit_id_fragment} Esempio: accounts/pub-9876543210987654/adUnits/0123456789
|
adUnitId |
string
L'ID visibile esternamente dell'unità pubblicitaria che può essere utilizzato per l'integrazione con l'SDK AdMob. Questa è una proprietà di sola lettura. Esempio: ca-app-pub-9876543210987654/0123456789
|
appId |
string
L'ID visibile esternamente dell'app a cui è associata questa unità pubblicitaria. Esempio: ca-app-pub-9876543210987654~0123456789
|
displayName |
string
Il nome visualizzato dell'unità pubblicitaria, come indicato nell'interfaccia utente di AdMob, fornito dall'utente. La lunghezza massima consentita è di 80 caratteri.
|
adFormat |
string
Il formato dell'annuncio dell'unità pubblicitaria. I valori possibili sono i seguenti: "APP_OPEN" - Formato dell'annuncio apertura app. "BANNER" - Formato dell'annuncio banner. "BANNER_INTERSTITIAL" - Formato precedente che può essere utilizzato come banner o interstitial. Questo formato non può più essere creato, ma può essere scelto come target dai gruppi di mediazione. "INTERSTITIAL" - Un annuncio a schermo intero. I tipi di annunci supportati sono "RICH_MEDIA" e "VIDEO". "NATIVO" - Formato dell'annuncio nativo. "PREMIATO" - Un annuncio che, una volta visualizzato, viene richiamato per verificare la visualizzazione per poter assegnare un premio all'utente. I tipi di annunci supportati sono "RICH_MEDIA" (interattivo) e video in cui non è possibile escludere i video. "REWARDED_INTERSTITIAL" - Formato dell'annuncio interstitial con premio. Supporta solo il tipo di annuncio video. Visita la pagina https://support.google.com/admob/answer/9884467.
|
adTypes[] |
string
Tipo di elemento multimediale dell'annuncio supportato da questa unità pubblicitaria. I valori possibili sono i seguenti: "RICH_MEDIA" - Testo, immagini e altri contenuti multimediali non video. "VIDEO" - Contenuti multimediali dei video.
|
rewardSettings |
object (RewardSettings)
(Facoltativo) Impostazioni per un'unità pubblicitaria con premio. Questo valore può essere impostato o meno solo quando il formato dell'annuncio è "REWARDED".
|
RewardSettings
Impostazioni per un'unità pubblicitaria con premio.
| Rappresentazione JSON |
{
"unitAmount": string,
"unitType": string
} |
| Campi |
unitAmount |
string (int64 format)
Importo del premio per questa unità pubblicitaria.
|
unitType |
string
Premio per questa unità pubblicitaria.
|
Metodi |
|
|
Crea un'unità pubblicitaria all'interno dell'account AdMob specificato. |
|
|
Elenca le unità pubblicitarie all'interno dell'account AdMob specificato. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-21 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]
