Method: accounts.adUnits.list

Elenca le unità pubblicitarie all'interno 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 query

Parametri
pageSize

integer

Il numero massimo di unità pubblicitarie da restituire. Se il valore non è specificato o se il valore è 0, verranno restituite al massimo 10.000 unità pubblicitarie. Il valore massimo è 20.000. valori superiori a 20.000 verranno costretti a 20.000.
pageToken

string

Il valore restituito dall'ultimo 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 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 passato 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 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.