Todas las llamadas a la API de Google AdMob deben autorizarse 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 controlar ni almacenar su nombre de usuario ni contraseña. Para obtener una descripción general de la autorización, consulta Autorización.
Realiza los siguientes pasos para generar las credenciales de OAuth2 y realizar tu primera solicitud.
Requisitos previos
Una Cuenta de Google
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 |
|
| App web |
|
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á a lo largo del 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.
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.
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.
- Establece el tipo de usuario en Externo y el estado de publicación en Publicado.
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.
Obtén información adicional para configurar tu pantalla de consentimiento de OAuth.
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, verás un ID y un secreto de cliente de OAuth 2.0, que puedes descargar en formato JSON y guardarlos para usarlos más tarde.
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 con la realización de solicitudes autorizadas. Las bibliotecas cliente están disponibles en varios lenguajes de programación. Con ellas, podrás evitar la necesidad de configurar las solicitudes HTTP y analizar las respuestas manualmente.
Ahora que creaste credenciales de OAuth 2.0, ya podrás 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 |
Consulta todos los datos de AdMob. Esto puede incluir información de la cuenta, la configuración de inventario y mediación, los informes y otros datos. 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:
Navega a la página de permisos de tu cuenta de Google y revoca el acceso del proyecto relevante.
Como alternativa, puedes revocar los tokens de aplicaciones web con la API de Google Identity.