Cuando usas OAuth 2.0 para la autorización, Google muestra una pantalla de consentimiento al usuario, que incluye un resumen de tu proyecto, sus políticas y los permisos de acceso de autorización solicitados. La configuración de la pantalla de consentimiento de OAuth de tu app define lo que se les muestra a los usuarios y revisores de la app, y registra tu app para que puedas publicarla más tarde.
Para definir el nivel de acceso otorgado a tu app, debes identificar y declarar los permisos de autorización. Un alcance de autorización es una string de URI de OAuth 2.0 que contiene el nombre de la app de Google Workspace, a qué tipo de datos accede y el nivel de acceso. Los permisos son las solicitudes de tu app para trabajar con datos de Google Workspace, incluidos los datos de la Cuenta de Google de los usuarios.
Cuando se instala tu app, se le solicita al usuario que valide los permisos que esta usa. En general, debes elegir el alcance más específico posible y evitar solicitar permisos que tu app no requiere. Los usuarios otorgan acceso a permisos limitados y claramente descritos.
Todas las apps que usan OAuth 2.0 requieren una configuración de pantalla de consentimiento, pero solo debes enumerar los permisos de las apps que usan personas ajenas a tu organización de Google Workspace.
Sugerencia: Si no conoces la información obligatoria de la pantalla de consentimiento, puedes usar la información del marcador de posición antes del lanzamiento.
Por motivos de seguridad, no puedes quitar la pantalla de consentimiento de OAuth 2.0 después de configurarla.
Configura el consentimiento de OAuth
- En la consola de Google Cloud, ve a Menú > APIs y servicios > Pantalla de consentimiento de OAuth.
- Selecciona el tipo de usuario de tu app y, luego, haz clic en Create.
- Completa el formulario de registro de la app y, luego, haz clic en Save and Continue.
Si creas una app para usar fuera de tu organización de Google Workspace, haz clic en Agregar o quitar permisos. Te aconsejamos las siguientes prácticas recomendadas cuando seleccionas los permisos:
- Selecciona los permisos que proporcionan el nivel de acceso mínimo que requiere tu app. Si quieres obtener una lista de los permisos disponibles, consulta Permisos de OAuth 2.0 para las API de Google.
- Revisa los permisos enumerados en cada una de las tres secciones: permisos no sensibles, permisos sensibles y permisos restringidos. En el caso de los permisos enumerados en las secciones “Tus permisos sensibles” o “Tus permisos restringidos”, intenta identificar permisos no sensibles alternativos para evitar revisiones adicionales innecesarias.
- Algunos permisos requieren revisiones adicionales de Google. En el caso de las apps que tu organización de Google Workspace usa de manera interna, los permisos no se enumeran en la pantalla de consentimiento, y el uso de permisos restringidos o sensibles no requiere una revisión adicional por parte de Google. Para obtener más información, consulta Categorías de permiso.
- Después de seleccionar los permisos que necesita tu app, haz clic en Save and Continue.
- Si seleccionaste Externo como tipo de usuario, agrega usuarios de prueba:
- En Usuarios de prueba, haz clic en Agregar usuarios.
- Ingresa tu dirección de correo electrónico y cualquier otro usuario de prueba autorizado. Luego, haz clic en Guardar y continuar.
- Revisa el resumen del registro de tu app. Para realizar cambios, haz clic en Editar. Si el registro de la app es correcto, haz clic en Volver al panel.
Categorías de alcance
Algunos permisos requieren revisiones y requisitos adicionales debido al nivel o el tipo de acceso que otorgan. Considera los siguientes tipos de alcances:
| Se requiere la verificación básica de la app | Se requiere una verificación adicional de la app | Evaluación de seguridad obligatoria | |||
|---|---|---|---|---|---|
| Alcances no sensibles (recomendado) | Otorga acceso solo a datos limitados que sean inmediatamente relevantes para una acción específica. | — | — | ||
 |
Alcances sensibles | Puedes otorgar acceso a acciones, recursos o datos personales de los usuarios. | — | ||
 |
Permisos restringidos | Otorga acceso a acciones o datos del usuario muy sensibles o extensos. |
Próximo paso
Crea credenciales de acceso para tu app.