Method: accounts.adUnits.list

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

string

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

Parametri di ricerca

Parametri
pageSize

integer

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

string

Il valore restituito dall'ultimo ListAdUnitsResponse; indica che si tratta di una 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 di 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 più unità pubblicitarie per la richiesta. Questo valore deve essere trasmesso in un nuovo ListAdUnitsRequest.

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

string

Nome risorsa per questa unità pubblicitaria. Il formato è accounts/{publisherId}/adUnits/{ad_unit_id_fragment} Esempio: accounts/pub-9876543210987654/adUnits/0123456789
adUnitId

string

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

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

string

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[]

string

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.