Method: accounts.adUnits.list

Genera 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 incluirá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 tiene el valor 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 convertirán en 20,000.
pageToken

string

El valor que muestra el último ListAdUnitsResponse; indica que esta 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

Es la respuesta a 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 un ListAdUnitsRequest nuevo.

Alcances 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 para 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 utilizar para realizar la integración con el SDK de AdMob. Esta es una propiedad de solo lectura. Ejemplo: ca-app-pub-9876543210987654/0123456789
appId

string

Es 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

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

string

Formato del anuncio de la unidad de anuncios. Los valores posibles son los siguientes:

“APP_OPEN” - Formato del anuncio de aplicación abierta. “BANNER” - Formato de anuncio de banner. “BANNER_INTERSTITIAL” - Formato heredado que se puede usar como banner o intersticial. Ya no se puede crear este formato, pero los grupos de mediación pueden segmentarse para él. “INTERSTIIAL” - Un anuncio de pantalla completa. Los tipos de anuncios admitidos son "RICH_MEDIA" y "VIDEO". "NATIVO" - Formato de anuncio nativo. “RECOMPENSA” - Un anuncio que, una vez visto, recibe una devolución de llamada en la que se verifica la vista para poder otorgar una recompensa al usuario. Los tipos de anuncios admitidos son "RICH_MEDIA" (interactivo) y los videos en los que no se pueden excluir videos “REWARDED_INTERSTITIAL” - Formato del anuncio intersticial recompensado. Solo es compatible con el tipo de anuncio de video. Consulta 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 sea de video "VIDEO" - Contenido multimedia de video