Este artículo es la traducción del blog inglés publicado el 8 de enero.
¿Qué cambios implementamos?
Google ofrece una amplia variedad de APIs que los desarrolladores de Google Apps Script pueden usar para crear funciones destinadas a los usuarios de Google. El acceso a los datos al que estas APIs pueden hacer referencia se rige por los permisos de OAuth de cada aplicación de Workspace, que los usuarios deben autorizar para que una secuencia de comandos pueda ejecutarse. Históricamente, en la pantalla de consentimiento de OAuth se le solicita al usuario que autorice todos los permisos necesarios de OAuth para que se pueda ejecutar una secuencia de comandos determinada.
En esta captura de pantalla, se muestra la anterior pantalla de consentimiento de OAuth, en la que el usuario debe autenticar todos los permisos de OAuth solicitados o ninguno de ellos.
A partir de hoy, la pantalla de consentimiento de OAuth les permitirá a los usuarios especificar qué permisos individuales de OAuth desean autorizar. Por ejemplo, si una secuencia de comandos solicita acceso a los archivos de Hojas de cálculo y Formularios de un usuario, y este solo quiere utilizar la secuencia de comandos con archivos de Hojas de cálculo, puede decidir permitir el acceso solo a sus hojas de cálculo, pero no a sus formularios. Esto les brinda a los usuarios el beneficio de tener un control más detallado sobre a qué datos pueden acceder sus aplicaciones de terceros.
En esta captura de pantalla, se muestra la nueva pantalla de consentimiento de OAuth, que permite que los usuarios den su consentimiento para un subconjunto de los permisos de OAuth solicitados.
Detalles adicionales
Para complementar el lanzamiento de este nuevo flujo de consentimiento, también agregaremos métodos a las clases ScriptApp y AuthorizationInfo que les permitan a los desarrolladores de Apps Script interactuar de forma programática con los permisos otorgados para una secuencia de comandos. Consulta la documentación para desarrolladores si quieres obtener más información.
Después de que un usuario le otorgue permiso a una secuencia de comandos, es posible que Apps Script vuelva a solicitar el consentimiento de OAuth en los siguientes casos:
Si el usuario que otorgó su consentimiento a un subconjunto de los permisos de OAuth solicitados intenta ejecutar una parte de la secuencia de comandos que no se había autorizado anteriormente.
Si la secuencia de comandos se actualiza de manera que requiera autorización para permisos adicionales.
Si el usuario le revocó el acceso a la secuencia de comandos desde la configuración de la Cuenta de Google.
Todos los errores de ejecución pasados se registrarán en el historial de ejecuciones. Cada error de OAuth incluirá un hipervínculo que los usuarios podrán utilizar para otorgar los permisos faltantes.
Primeros pasos
Administradores: No hay ningún control de administrador para esta función.
Desarrolladores y usuarios finales:
El consentimiento detallado de OAuth solo está disponible para las secuencias de comandos que se hayan terminado de migrar al entorno de ejecución de V8. Si quieres usar el consentimiento detallado en una de las pocas secuencias de comandos restantes de Rhino, puedes seguir estas instrucciones para migrar a V8.
Esta nueva pantalla de consentimiento solo se usará para las nuevas solicitudes de permisos de OAuth. Las solicitudes existentes no se verán afectadas, así que los usuarios no deben realizar ninguna acción en las secuencias de comandos que ya autorizaron.
La nueva pantalla de consentimiento se lanzará primero en el IDE de Apps Script (es decir, en secuencias de comandos que se ejecuten directamente desde Apps Script). La pantalla de consentimiento se lanzará en las plataformas restantes en el futuro:
Secuencia de comandos de Google Ads
Ejecuciones de macros
Ejecuciones de activadores
Ejecuciones de apps web
Ejecuciones de APIs
Apps de chat
Complementos
Ritmo de lanzamiento
Dominios de lanzamiento rápido y programado: Se realizará un lanzamiento extendido (posiblemente más de 15 días para la visibilidad de la función) a partir del 8 de enero de 2025. Se espera que finalice el 24 de enero de 2025.
Disponibilidad
Estará disponible para todos los clientes de Google Workspace y los suscriptores de Workspace Individual.
Recursos
Documentación para desarrolladores: Cómo migrar secuencias de comandos al entorno de ejecución de V8
Documentación para desarrolladores: Clase ScriptApp