- Richiesta HTTP
- Parametri del percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- AdUnit
- Esempi
- Prova!
Elenca le unità pubblicitarie dell'account AdMob specificato.
Richiesta HTTP
GET https://admob.googleapis.com/v1/{parent=accounts/*}/adUnits
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
parent |
Obbligatorio. Nome della risorsa dell'account per cui elencare le unità pubblicitarie. Esempio: accounts/pub-9876543210987654 |
Parametri di ricerca
Parametri | |
---|---|
pageSize |
Il numero massimo di unità pubblicitarie da restituire. Se il valore non è specificato o è pari a 0, verranno restituite al massimo 10.000 unità pubblicitarie. Il valore massimo è 20.000; i valori superiori a 20.000 verranno costretti a 20.000. |
pageToken |
Il valore restituito dall'ultimo |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Risposta alla richiesta di elenco delle unità pubblicitarie.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"adUnits": [
{
object ( |
Campi | |
---|---|
adUnits[] |
Le unità pubblicitarie risultanti per l'account richiesto. |
nextPageToken |
Se non vuoto, indica che potrebbero esserci più unità pubblicitarie per la richiesta. Questo valore deve essere trasmesso in un nuovo |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/admob.readonly
Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.
AdUnit
Descrive un'unità pubblicitaria AdMob.
Rappresentazione JSON |
---|
{ "name": string, "adUnitId": string, "appId": string, "displayName": string, "adFormat": string, "adTypes": [ string ] } |
Campi | |
---|---|
name |
Nome risorsa per questa unità pubblicitaria. Il formato è accounts/{publisherId}/adUnits/{ad_unit_id_fragment} Esempio: accounts/pub-9876543210987654/adUnits/0123456789 |
adUnitId |
L'ID dell'unità pubblicitaria visibile esternamente che può essere utilizzato per l'integrazione con l'SDK AdMob. Questa è una proprietà di sola lettura. Esempio: ca-app-pub-9876543210987654/0123456789 |
appId |
L'ID visibile esternamente dell'app a cui è associata questa unità pubblicitaria. Esempio: ca-app-pub-9876543210987654~0123456789 |
displayName |
Il nome visualizzato dell'unità pubblicitaria come mostrato nell'interfaccia utente di AdMob e fornito dall'utente. La lunghezza massima consentita è 80 caratteri. |
adFormat |
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". "NATIVE": formato dell'annuncio nativo. "PREMIATO": un annuncio che, una volta visualizzato, riceve una richiamata per verificare la visualizzazione in modo da poter assegnare un premio all'utente. I tipi di annunci supportati sono "RICH_MEDIA" (interattivi) e video in cui i video non possono essere esclusi. "REWARDED_INTERSTITIAL" - Formato dell'annuncio interstitial con premio. Supporta solo il tipo di annuncio video. Consulta la pagina https://support.google.com/admob/answer/9884467. |
adTypes[] |
Tipo di annuncio multimediale supportato da questa unità pubblicitaria. I valori possibili sono i seguenti: "RICH_MEDIA": testo, immagini e altri contenuti multimediali non video. "VIDEO": contenuti multimediali video. |