Autorización para los servicios de Google

Apps Script requiere la autorización del usuario para acceder a los datos privados de los servicios de Google integrados o los servicios de Google avanzados.

Otorga derechos de acceso

Apps Script determina los permisos de autorización (como el acceso a tus archivos de Hojas de cálculo de Google o Gmail) automáticamente, en función de un escaneo del código. El código marcado como comentario puede generar una solicitud de autorización. Si una secuencia de comandos necesita autorización, cuando se ejecute, verás uno de los diálogos de autorización que se muestran aquí.

Las secuencias de comandos que autorizaste con anterioridad también solicitan autorización adicional si un cambio en el código agrega servicios nuevos. Es posible que las secuencias de comandos no soliciten autorización si accedes a la secuencia de comandos como una aplicación web que se ejecuta según la identidad de usuario del propietario de la secuencia de comandos.

Revocación de derechos de acceso

Para revocar el acceso de una secuencia de comandos a tus datos, sigue estos pasos:

  1. Visita la página de permisos de tu Cuenta de Google. (Para navegar a esta página en el futuro, visita Google.com y, luego, haz clic en la imagen de tu cuenta en la esquina superior derecha de la pantalla. Luego, haz clic en Mi cuenta, luego, en Aplicaciones y sitios conectados en la sección "Acceso y seguridad", y, por último, en Administrar aplicaciones).
  2. Haz clic en el nombre de la secuencia de comandos cuya autorización deseas revocar. Luego, haz clic en Remove a la derecha y, luego, en OK en el cuadro de diálogo que se genera.

Permisos y tipos de secuencias de comandos

La identidad del usuario con la que se ejecuta una secuencia de comandos (y, por lo tanto, los datos a los que puede acceder) varía según la situación en la que se ejecuta la secuencia de comandos, como se muestra en la siguiente tabla.

Tipo de secuencia de comandos La secuencia de comandos se ejecuta como...
Independiente, complemento o vinculada a Documentos, Hojas de cálculo, Presentaciones o Formularios Usuario en el teclado
Función personalizada en una hoja de cálculo Usuario anónimo; sin embargo, los límites de cuota se descuentan de los usuarios que utilizan el teclado.
App web o widget de Google Sites Usuario del propietario del teclado o de la secuencia de comandos, que depende de las opciones seleccionadas al implementar la app
Activador instalable Usuario que creó el activador

Alcances de autorización manual para Hojas de cálculo, Documentos, Presentaciones y Formularios

Si compilas un complemento o una secuencia de comandos de otro tipo que usa el servicio de Hojas de cálculo, el servicio de Documentos, el servicio de Presentaciones o el servicio de Formularios, puedes forzar el diálogo de autorización para que solicite acceso solo a los archivos en los que se usa el complemento o la secuencia de comandos, en lugar de todas las hojas de cálculo, los documentos o los formularios del usuario. Para hacerlo, incluye la siguiente anotación JsDoc en un comentario a nivel de archivo:

/**
 * @OnlyCurrentDoc
 */

Una anotación opuesta, @NotOnlyCurrentDoc, estará disponible si tu secuencia de comandos incluye una biblioteca que declara @OnlyCurrentDoc, pero la secuencia de comandos principal en realidad requiere acceso a más que al archivo actual.

Ciclo de vida de la autorización para complementos

En general, los complementos para Hojas de cálculo, Documentos, Presentaciones y Formularios de Google siguen el mismo modelo de autorización que las secuencias de comandos vinculadas a un documento. Sin embargo, en ciertas circunstancias, sus funciones onOpen(e) y onEdit(e) se ejecutan en un modo sin autorización que presenta algunas complicaciones adicionales. Para obtener más información, consulta la guía del ciclo de vida de autorización de complementos.

Límites de usuarios de aplicaciones de OAuth

Las aplicaciones que usan OAuth para acceder a los datos del usuario de Google, incluidos los proyectos de Apps Script, están sujetas a límites de autorización. Consulta Límites de usuarios de la aplicación OAuth para obtener más detalles.