Method: accounts.adUnits.list

Obtén una lista de las unidades de anuncios en la cuenta de AdMob especificada.

Solicitud HTTP

GET https://admob.googleapis.com/v1/{parent=accounts/*}/adUnits

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Es el nombre del recurso de la cuenta para la que se enumerarán las unidades de anuncios. Ejemplo: accounts/pub-9876543210987654

Parámetros de consulta

Parámetros
pageSize

integer

Es la cantidad máxima de unidades de anuncios que se mostrarán. Si no se especifica o el valor es 0, se mostrarán 10,000 unidades de anuncios como máximo. El valor máximo es 20,000; los valores superiores a 20,000 se forzarán a 20,000.
pageToken

string

Valor que mostró el último ListAdUnitsResponse; indica que es una continuación de una llamada a adUnits.list anterior y que el sistema debe mostrar la siguiente página de datos.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta de la solicitud de la lista de unidades de anuncios.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "adUnits": [
    {
      object (AdUnit)
    }
  ],
  "nextPageToken": string
}
Campos
adUnits[]

object (AdUnit)

Son las unidades de anuncios resultantes de la cuenta solicitada.
nextPageToken

string

Si no está vacío, indica que puede haber más unidades de anuncios para la solicitud. Este valor se debe pasar en una ListAdUnitsRequest nueva.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la Descripción general de OAuth 2.0.

AdUnit

Describe una unidad de anuncios de AdMob.

Representación JSON 
{
  "name": string,
  "adUnitId": string,
  "appId": string,
  "displayName": string,
  "adFormat": string,
  "adTypes": [
    string
  ]
}
Campos
name

string

Es el nombre del recurso de esta unidad de anuncios. El formato es accounts/{publisherId}/adUnits/{ad_unit_id_fragment}. Ejemplo: accounts/pub-9876543210987654/adUnits/0123456789
adUnitId

string

Es el ID visible externamente de la unidad de anuncios que se puede usar para integrar el SDK de AdMob. Esta es una propiedad de solo lectura. Ejemplo: ca-app-pub-9876543210987654/0123456789
appId

string

El ID visible externamente de la aplicación con la que está asociada esta unidad de anuncios. Ejemplo: ca-app-pub-9876543210987654~0123456789
displayName

string

Es el nombre visible de la unidad de anuncios como aparece en la IU de AdMob y que proporciona el usuario. La longitud máxima permitida es de 80 caracteres.
adFormat

string

AdFormat de la unidad de anuncios. Los valores posibles son los siguientes:

"APP_OPEN": Formato del anuncio de aplicación abierta. "BANNER": Formato de anuncio en forma de banner. "BANNER_INTERSTITIAL": Formato heredado que se puede usar como banner o intersticial. Este formato ya no se puede crear, pero se pueden segmentar mediante grupos de mediación. "INTERSTITIAL": Es un anuncio de pantalla completa. Los tipos de anuncios admitidos son "RICH_MEDIA" y "VIDEO". "NATIVE": Es el formato del anuncio nativo. "RECOMPENSADO": Es un anuncio que, una vez visto, recibe una devolución de llamada que verifica la vista para que el usuario pueda recibir una recompensa. Los tipos de anuncios admitidos son "RICH_MEDIA" (interactivo) y video donde no se puede excluir video. "REWARDED_INTERSTITIAL": Formato del anuncio intersticial recompensado. Solo es compatible con el tipo de anuncio de video. Consulte https://support.google.com/admob/answer/9884467.
adTypes[]

string

Es el tipo de medio del anuncio compatible con esta unidad de anuncios. Estos son los valores posibles:

"RICH_MEDIA": texto, imagen y otro contenido multimedia que no es de video "VIDEO": contenido multimedia de video.