- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- AdUnit
- Ejemplos
- Pruébala
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 |
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 |
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 |
Valor que mostró el último |
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 ( |
Campos | |
---|---|
adUnits[] |
Son las unidades de anuncios resultantes de la cuenta solicitada. |
nextPageToken |
Si no está vacío, indica que puede haber más unidades de anuncios para la solicitud. Este valor se debe pasar en una |
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 |
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 |
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 |
El ID visible externamente de la aplicación con la que está asociada esta unidad de anuncios. Ejemplo: ca-app-pub-9876543210987654~0123456789 |
displayName |
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 |
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[] |
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. |