Apps Script requiere la autorización del usuario para acceder a datos privados de los servicios integrados de Google o los servicios avanzados de Google.
Cómo otorgar derechos de acceso
Apps Script determina automáticamente los permisos de autorización (como el acceso a tus archivos de Hojas de cálculo de Google o Gmail) en función de un análisis del código. El código que se comenta aún puede generar una solicitud de autorización. Si una secuencia de comandos necesita autorización, verás uno de los diálogos de autorización que se muestran aquí cuando se ejecute.
Los secuencias de comandos que autorizaste anteriormente también solicitan autorización adicional si un cambio de código agrega servicios nuevos. Es posible que las secuencias de comandos no soliciten autorización si accedes a ellas como una app web que se ejecuta con la identidad de usuario del propietario de la secuencia de comandos.
Cómo revocar derechos de acceso
Para revocar el acceso de una secuencia de comandos a tus datos, sigue estos pasos:
- 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 foto de tu cuenta en la esquina superior derecha de la pantalla. A continuación, haz clic en Mi cuenta, luego en Apps y sitios conectados en la sección "Acceso y seguridad" y, por último, en Administrar apps.
- Haz clic en el nombre de la secuencia de comandos cuya autorización deseas revocar, luego, haz clic en Quitar a la derecha y, luego, en Aceptar 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ían 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 vinculado 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 aplican al usuario que está escribiendo. |
| App web o gadget de Google Sites | Usuario en el teclado o propietario del script, según las opciones seleccionadas al implementar la app |
| Activador instalable | Usuario que creó el activador |
Permisos de autorización manuales para Hojas de cálculo, Documentos, Presentaciones y Formularios
Si compilas un complemento o cualquier otro código que use los servicios de Spreadsheet, Document, Slides o Forms, puedes forzar el diálogo de autorización para que solo solicite acceso a los archivos en los que se usa el complemento o el código, en lugar de a todas las hojas de cálculo, documentos o formularios de un usuario. Para ello, incluye la siguiente anotación JsDoc en un comentario a nivel del 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 que el archivo actual.
Ciclo de vida de la autorización de complementos
Los complementos para Hojas de cálculo, Documentos, Presentaciones y Formularios de Google generalmente 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 la autorización de complementos.
Límites de usuarios de la aplicación de OAuth
Las aplicaciones que usan OAuth para acceder a los datos de los usuarios de Google, incluidos los proyectos de Apps Script, están sujetas a límites de autorización. Consulta los límites de usuarios de aplicaciones OAuth para obtener más detalles.