Method: accounts.adUnits.list

Elenca le unità pubblicitarie nell'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

string

Obbligatorio. Il nome della risorsa dell'account per cui elencare le unità pubblicitarie. Esempio: accounts/pub-9876543210987654

Parametri di query

Parametri
pageSize

integer

Il numero massimo di unità pubblicitarie da restituire. Se 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 forzati a 20.000.
pageToken

string

Il valore restituito dall'ultima ListAdUnitsResponse indica che si tratta della continuazione di una chiamata adUnits.list precedente e che il sistema deve restituire la pagina di dati successiva.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta alla richiesta dell'elenco delle unità pubblicitarie.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "adUnits": [
    {
      object (AdUnit)
    }
  ],
  "nextPageToken": string
}
Campi
adUnits[]

object (AdUnit)

Le unità pubblicitarie risultanti per l'account richiesto.
nextPageToken

string

Se non è vuoto, indica che potrebbero esserci altre unità pubblicitarie per la richiesta; questo valore deve essere passato in un nuovo ListAdUnitsRequest.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/admob.readonly

Per saperne di più, consulta la OAuth 2.0 Overview.

AdUnit

Descrive un'unità pubblicitaria AdMob.

Rappresentazione JSON 
{
  "name": string,
  "adUnitId": string,
  "appId": string,
  "displayName": string,
  "adFormat": string,
  "adTypes": [
    string
  ]
}
Campi
name

string

Il 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 mostrato nell'interfaccia utente di AdMob, fornito dall'utente. La lunghezza massima consentita è di 80 caratteri.
adFormat

string

AdFormat dell'unità pubblicitaria. I valori possibili sono:

"APP_OPEN": formato dell'annuncio apertura app. "BANNER": formato dell'annuncio banner. "BANNER_INTERSTITIAL": formato legacy 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 annuncio supportati sono "RICH_MEDIA" e "VIDEO". "NATIVE" - Formato dell'annuncio nativo. "CON PREMIO": un annuncio che, una volta visualizzato, riceve un callback che verifica la visualizzazione in modo che possa essere assegnato 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. Vedi https://support.google.com/admob/answer/9884467.
adTypes[]

string

Tipo di contenuti multimediali dell'annuncio supportato da questa unità pubblicitaria. I valori possibili sono:

"RICH_MEDIA": testo, immagini e altri contenuti multimediali non video. "VIDEO" - Contenuti multimediali video.