Apps Script requiere la autorización del usuario para acceder a los datos privados de servicios de Google integrados o servicios de Google avanzados.
Otorgamiento de derechos de acceso
![](https://developers-dot-devsite-v2-prod.appspot.com/static/apps-script/images/new-auth-1.png?authuser=3&hl=es-419)
![](https://developers-dot-devsite-v2-prod.appspot.com/static/apps-script/images/new-auth-2.png?authuser=3&hl=es-419)
Apps Script determina los permisos de autorización (como el acceso a tus archivos o Gmail) automáticamente, en función de un escaneo del código. Código que se comentado aún puede generar una solicitud de autorización. Si un guion necesita autorización, verás uno de los diálogos de autorización que se muestran aquí cuando cuando se ejecute.
Las secuencias de comandos que autorizaste previamente también solicitan información autorización si un cambio de 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 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:
- Visita el página de permisos para 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 Apps conectadas y sitios en la "Acceso y seguridad" y, luego, en Administrar aplicaciones).
- Haga clic en el nombre de la secuencia de comandos cuya autorización desea revocar; luego, Haz clic en Remove a la derecha y, luego, en OK en el diálogo resultante.
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 ejecute la secuencia de comandos, como se muestra en la tabla a continuación.
Tipo de secuencia de comandos | La secuencia de comandos se ejecuta como... |
---|---|
Independientes, complemento o . Vinculado a Documentos, Hojas de cálculo, Presentaciones o Formularios | Usuario al tocar el teclado |
Función personalizada en una hoja de cálculo | Usuario anónimo Sin embargo, los límites de cuota contar contra usuario al usar el teclado |
App web o Widget de Google Sites | Usuario del teclado o propietario de la secuencia de comandos, según opciones seleccionadas cuando implementes la app |
Activador instalable | Usuario que creó el activador |
Alcances de autorización manual para Hojas de cálculo, Documentos, Presentaciones y Formularios
Si estás creando un complemento u otra secuencia de comandos que usa el servicio Spreadsheets, Servicio de documentos El servicio de Presentaciones o Servicio de Formularios, puedes forzar la autorización. para solicitar 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
*/
Hay una anotación opuesta, @NotOnlyCurrentDoc
, 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 de
el archivo actual.
Ciclo de vida de la autorización para los complementos
Complementos para Hojas de cálculo, Documentos, Presentaciones y Formularios de Google
suelen seguir el mismo modelo de autorización que las secuencias de comandos
vinculada a un documento. En algunos
Sin embargo, sus funciones onOpen(e)
y onEdit(e)
se ejecutan en un
modo sin autorización que presenta algunas complicaciones adicionales. Para ver más
información, consulta la
guía sobre el ciclo de vida de autorización de complementos.
Límites de usuarios de la aplicación de OAuth
Aplicaciones que usan OAuth para acceder a datos de usuario de Google, incluidas las aplicaciones Los proyectos de secuencias de comandos están sujetos a límites de autorización. Consulta Límites de usuarios de la aplicación de OAuth para conocer los detalles.