06. Permisos específicos (Scopes)

Seguimos en nuestro curso de Google Apps Script y en esta lección 06 vamos a hablar de un tema fundamental: los permisos específicos o scopes que nuestra aplicación necesita para funcionar correctamente.

En este video veremos cómo configurar correctamente los permisos OAuth en Google Cloud para que nuestra app pueda acceder a servicios como Google Sheets, Drive o Calendar, sin dar más acceso del necesario. Te mostraré paso a paso cómo habilitar las APIs, añadir los scopes requeridos y solucionar un bug común con el scope ScriptContainerUI.

Para quienes aún no son miembros, les recuerdo que suscribiéndose podrán acceder a los videos, materiales descargables y soporte exclusivo para avanzar más rápido en sus proyectos con Google Apps Script.

Como viste en el video, el paso clave para que tu script funcione con los permisos adecuados es habilitar primero las APIs necesarias en Google Cloud, especialmente Google Sheets API y la Google Apps Script API. Luego, en la pantalla de consentimiento OAuth, debes añadir los scopes que definen qué recursos podrá usar tu app. Para un complemento básico de Sheets, los scopes mínimos son SpreadsheetsCurrentOnly (para acceso solo a la hoja donde se instala) y ScriptContainerUI (para mostrar interfaces y pop-ups).

Un detalle importante es que el scope ScriptContainerUI a veces no aparece en el buscador por un bug, así que tendrás que pegar manualmente su identificador. Una vez añadidos, guarda la configuración y verás ambos permisos en la lista, uno no sensible y otro sensible. Si tu proyecto usa otros servicios, busca y añade los scopes correspondientes según la documentación oficial o con ayuda de asistentes.

Con estos permisos básicos, no necesitas verificar la app para este caso simple, y ya puedes regresar a Google Sheets y Apps Script para seguir ajustando tu complemento. En la próxima lección continuaremos con la implementación práctica de estos permisos y cómo aprovecharlos para mejorar la funcionalidad.

Si quieres ver el video, descargar los materiales, obtener soporte y mucho más, suscríbete a JuanSGuzman aquí.