Configuración de OAuth

Todas las llamadas a la API de Google AdMob deben autorizarse 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 un usuario de AdMob sin tener que controlar ni almacenar el nombre de usuario o la contraseña del usuario. 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

• Conocimiento de los conceptos básicos de REST y la autorización de solicitudes con OAuth 2.0

Determina tu tipo de autenticación

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

Elige tu tipo de autenticación 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 una sola máquina.
App web	Deseas autenticarte como un usuario que puede otorgar permiso a tu app para acceder a los datos de la cuenta de la API de AdMob. Quieres generar fácilmente varias credenciales de autorización, por ejemplo, para administrar cuentas de terceros. Tu app requiere URLs de devolución de llamada, que no se admiten en el flujo de la app para computadoras.

Punto clave: Puedes elegir el flujo de la app para computadoras, incluso si desarrollas una app para que se ejecute en un servidor. La diferencia radica en si la autorización de OAuth se completa de forma local o remota. Un flujo de escritorio requiere que se complete la autorización en la máquina local, mientras que el flujo web permite que se complete la autorización 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á en el proceso y activará la API de AdMob automáticamente.

Cómo habilitar 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 tu proyecto, sigue estos pasos:

1. Abre la Biblioteca de APIs en la Consola de APIs de Google.
2. Si se te solicita, selecciona un proyecto o crea uno nuevo. La Biblioteca de APIs muestra todas las APIs disponibles, agrupadas por familia de productos y popularidad.
3. Si la API que quieres habilitar no está en la lista, usa la búsqueda para encontrarla o haz clic en Ver todo en la familia de productos a la que pertenece.
4. Selecciona la API que deseas habilitar y, luego, haz clic en el botón Habilitar.
5. Si se te solicita, habilita la facturación.
6. Si se te solicita, lee y acepta las Condiciones del Servicio de la API.

Crea credenciales de OAuth2

Las siguientes instrucciones te guiarán en el proceso de creación de un ID de cliente de OAuth 2.0 para usar con el flujo de aplicación instalada.

1. Ve a la página Clientes.

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, se te indicará 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. Establece tu 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, selecciona Agregar usuarios para agregar Usuarios de prueba y darles acceso para usar tu ID de cliente de OAuth 2.0.

      Consulta información adicional para configurar tu pantalla de consentimiento de OAuth.

3. Selecciona Aplicación para computadoras 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 del cliente de OAuth 2.0, que puedes descargar en formato JSON y guardar para usar 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 las APIs de Google ofrecen una mejor integración de lenguajes, 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 que haya accedido en ese momento.

Una vez que creaste las credenciales de OAuth 2.0, puedes comenzar a usar la API de AdMob. Para solicitar acceso con OAuth 2.0, tu app también necesita información sobre el permiso:

Alcance	Significado
https://www.googleapis.com/auth/admob.readonly	Ver todos los datos de AdMob Esto puede incluir información de la cuenta, la configuración del inventario y la mediación, informes y otros datos. No se incluyen datos sensibles, como detalles de pagos o campañas.
https://www.googleapis.com/auth/admob.report	Ver informes de ganancias y rendimiento del anuncio Ver el ID del publicador, la zona horaria y el código de moneda predeterminada

Realiza tu primera solicitud para generar un informe con los 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 pertinente.

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