Primeros pasos con la API de AdMob

Esta guía está destinada a los desarrolladores que desean utilizar la API de AdMob para obtener información sobre su cuenta de AdMob de manera programática.

Todas las llamadas a la API de Google AdMob se deben autorizar a través de OAuth2 para que la app pueda interactuar con los servicios web en nombre del usuario. OAuth2 permite que tu app cliente de la API de AdMob acceda a la cuenta de AdMob de un usuario sin tener que manejar ni almacenar su nombre de usuario o contraseña. Para obtener una descripción general de la autorización, consulta Autorización.

Sigue estos pasos para generar las credenciales de OAuth2 y realizar tu primera solicitud.

Requisitos previos

Cómo determinar el tipo de autenticación

Consulta la siguiente tabla para ver qué tipo de autenticación es el más apropiado para tu app:

Elige tu tipo de autenticación de OAuth2 Si ...
App para computadoras
  • Administras todas tus cuentas de la API de AdMob con una sola cuenta de administrador de nivel superior.
  • Eres un usuario nuevo o quieres comenzar rápidamente con la configuración más sencilla.
  • Tu app solo autentica a los usuarios de Google AdMob desde un equipo.
App web
  • Deseas autenticarte como un usuario que puede otorgar permiso a tu app para acceder a los datos de su cuenta de la API de AdMob.
  • Deseas generar con facilidad varias credenciales de autorización, por ejemplo, para administrar cuentas de terceros.
  • Tu app necesita URL de devolución de llamada, pero estas no son compatibles con el flujo de la app de escritorio.

Cómo crear un proyecto

Para comenzar a usar la API de AdMob, primero debes crear o seleccionar un proyecto en la Consola de API de Google y habilitar la API con la herramienta de configuración, que te guiará en el proceso y activará la API de AdMob automáticamente.

Habilita la API para un proyecto existente

Los siguientes pasos se aplican a los usuarios que tienen un proyecto existente y prefieren activar la API de AdMob para él de forma manual.

Para habilitar una API para su proyecto:

  1. Open the API Library en Google API Console .
  2. If prompted, select a project, or create a new one. El API Library enumera todas las API disponibles, agrupadas por familia de productos y popularidad.
  3. Si la API que desea habilitar no está visible en la lista, use la búsqueda para encontrarla o haga clic en Ver todo en la familia de productos a la que pertenece.
  4. Seleccione la API que desea habilitar, luego haga clic en el botón Habilitar .
  5. If prompted, enable billing.
  6. If prompted, read and accept the API's Terms of Service.

Crear credenciales de OAuth2

Las siguientes instrucciones te guiarán a través del proceso de creación de un ID de cliente de OAuth 2.0 para usar con el flujo de la app instalada.

  1. Go to the Credentials page.

  2. Haz clic en CREAR CREDENCIALES > ID de cliente de OAuth.

    Si no habías configurado una pantalla de consentimiento de OAuth para este proyecto antes, se te pedirá que lo hagas ahora. Haz clic en CONFIGURAR PANTALLA DE CONSENTIMIENTO. Existen varias formas de configurar tu pantalla de consentimiento para usar tu ID de cliente de OAuth 2.0.

    1. Configura el tipo de usuario como Externo y el estado de publicación como Publicado.

    2. También puedes configurar tu tipo de usuario como Externo y el estado de publicación en Pruebas. Luego, agrega Usuarios de prueba. Para ello, selecciona agregar usuarios a fin de otorgarles acceso para usar tu ID de cliente de OAuth 2.0.

      Consulta información adicional sobre cómo configurar tu pantalla de consentimiento de OAuth.

  3. Selecciona App de escritorio o Aplicación web como el tipo de aplicación, asígnale un nombre y haz clic en Crear.

Cuando hayas terminado, aparecerá un ID y un secreto de cliente de OAuth 2.0, que puedes descargar en formato JSON y guardarlos para usarlos en otro momento.

Haz una solicitud

La API de AdMob se basa en HTTP y JSON, por lo que cualquier cliente HTTP estándar puede enviarle solicitudes y analizar las respuestas. Sin embargo, las bibliotecas cliente de la API de Google ofrecen una mejor integración de lenguajes y una mayor seguridad, además de asistencia para realizar solicitudes autorizadas. Las bibliotecas cliente están disponibles en varios lenguajes de programación. Con ellos, podrás evitar la necesidad de configurar manualmente las solicitudes HTTP y de analizar las respuestas.

Con las credenciales de OAuth 2.0 creadas, estás listo para comenzar a usar la API de AdMob. Para solicitar acceso con OAuth 2.0, tu app también necesita información de alcance:

Permiso Significado
https://www.googleapis.com/auth/admob.readonly Ver todos los datos de AdMob. Estos pueden incluir información de la cuenta, informes y configuración de inventario y mediación, entre otros. No se incluyen datos sensibles, como detalles de pagos o campañas.
https://www.googleapis.com/auth/admob.report Consulta los informes de rendimiento y de ingresos de los anuncios. Consulta el ID de publicador, la zona horaria y el código de moneda predeterminado.

Realiza tu primera solicitud para generar un informe con ejemplos en Java, PHP, Python o curl.

Revoca los tokens compartidos

Puedes revocar tokens compartidos de dos maneras:

  1. Navega a la página de permisos de tu Cuenta de Google y revoca el acceso desde el proyecto relevante.

  2. Como alternativa, puedes revocar tokens de aplicación web con la API de Google Identity.