Comienza a usar la API de AdMob

Importante: Los nuevos roles y permisos de los usuarios afectarán los datos que devuelve la API de AdMob. Más información

Esta guía está dirigida a los desarrolladores que desean usar la API de AdMob para obtener datos de forma programática en su cuenta de AdMob.

Todas las llamadas a la API de Google AdMob deben estar autorizadas a través de OAuth2 para que tu 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 controlar ni almacenar su nombre de usuario ni 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

• Una Cuenta de Google

• Una cuenta de Google AdMob

• Familiaridad con los conceptos básicos de REST y autorizar solicitudes con OAuth 2.0

Determina tu tipo de autenticación

Consulta la siguiente tabla para ver qué tipo de autenticación es 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. Es la primera vez que usas la app o quieres comenzar rápidamente con la configuración más simple. Tu app solo autentica a los usuarios de Google AdMob desde una máquina.
App web	Quieres autenticarte como un usuario que puede otorgar permiso a tu app para acceder a los datos de su cuenta de la API de AdMob. Quieres generar varias credenciales de autorización fácilmente para administrar, por ejemplo, cuentas de terceros. Tu app requiere URLs de devolución de llamada. Las URLs de devolución de llamada no son compatibles con el flujo de apps para computadoras de escritorio.

Punto clave: Puedes elegir el flujo de la app para computadoras de escritorio, incluso si estás desarrollando una app para ejecutar en un servidor. La diferencia es si la autorización de OAuth se completa de forma local o remota. Un flujo para computadoras de escritorio requiere que la autorización se complete en la máquina local, mientras que el flujo web permite que la autorización se complete en el servidor de autorización de Google.

Crea un proyecto

Para comenzar a usar la API de AdMob, primero debes crear o seleccionar un proyecto en la Consola de APIs de Google y habilitar la API con la herramienta de configuración, que te guiará por 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 de forma manual.

To enable an API for your project:

1. Open the API Library in the Google API Console.
2. If prompted, select a project, or create a new one. The API Library lists all available APIs, grouped by product family and popularity.
3. If the API you want to enable isn't visible in the list, use search to find it, or click View All in the product family it belongs to.
4. Select the API you want to enable, then click the Enable button.
5. If prompted, enable billing.
6. If prompted, read and accept the API's Terms of Service.

Crea credenciales de OAuth2

Las siguientes instrucciones te guiarán durante el proceso de creación de un ID de cliente de OAuth 2.0 para usarlo 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 configuraste una pantalla de consentimiento de OAuth para este proyecto con anterioridad, se te indicará que lo hagas ahora. Haz clic en CONFIGURAR PANTALLA DE CONSENTIMIENTO. Existen varias formas de configurar la pantalla de consentimiento para usar tu ID de cliente de OAuth 2.0.

   1. Establece el tipo de usuario en Externo y el estado de publicación en Publicado.

   2. También puedes establecer el tipo de usuario como Externo y el estado de publicación como Prueba. Luego, agrega Usuarios de prueba seleccionando Agregar usuarios para darles acceso y que puedan usar tu ID de cliente de OAuth 2.0.

      Consulta información adicional para 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, luego, haz clic en Crear.

Cuando termines, se te mostrarán un ID de cliente y un secreto de cliente de OAuth 2.0, que puedes descargar en formato JSON y guardar para usarlos más adelante.

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 proporcionan una mejor integración de lenguajes, una mayor seguridad y compatibilidad para realizar solicitudes autorizadas. Las bibliotecas cliente están disponibles en varios lenguajes de programación. Con ellas, podrás evitar la necesidad de configurar manualmente las solicitudes HTTP y de analizar las respuestas.

Nota: La primera vez que actives el flujo de OAuth, se te pedirá que proporciones tu ID de publicador de AdMob y que aceptes un mensaje de autorización en tu navegador. Antes de aceptar, asegúrate de haber accedido con una Cuenta de Google que tenga acceso a tu cuenta de AdMob. Luego, tu app estará autorizada para acceder a los datos en nombre de la cuenta con la que se accedió.

Con las credenciales de OAuth 2.0 creadas, ya puedes comenzar a usar la API de AdMob. Para solicitar acceso con OAuth 2.0, tu app también necesita información del permiso:

Alcance	Significado
https://www.googleapis.com/auth/admob.readonly	Consultar todos los datos de AdMob Estos datos pueden incluir la información de la cuenta, los informes y la 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	Consultar los informes de rendimiento y ganancias de los anuncios Consulta el ID del publicador, la zona horaria y el código de moneda predeterminada.

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

Cómo revocar tokens compartidos

Puedes revocar los tokens compartidos de dos maneras:

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

2. Como alternativa, puedes revocar los tokens de aplicaciones web con la API de Google Identity.