Es una enumeración que identifica qué categorías de servicios autorizados puede ejecutar Apps Script a través de una función activada. Estos valores se exponen en las funciones activadas como la propiedad auth
del parámetro de evento, e
. Para obtener más información, consulta la guía del ciclo de vida de la autorización de complementos.
Para llamar a una enumeración, debes llamar a su clase superior, nombre y propiedad. Por ejemplo,
ScriptApp.AuthMode.CUSTOM_FUNCTION
.
function onOpen(e) { const menu = SpreadsheetApp.getUi().createAddonMenu(); if (e && e.authMode === ScriptApp.AuthMode.NONE) { // Add a normal menu item (works in all authorization modes). menu.addItem('Start workflow', 'startWorkflow'); } else { // Add a menu item based on properties (doesn't work in AuthMode.NONE). const properties = PropertiesService.getDocumentProperties(); const workflowStarted = properties.getProperty('workflowStarted'); if (workflowStarted) { menu.addItem('Check workflow status', 'checkWorkflow'); } else { menu.addItem('Start workflow', 'startWorkflow'); } // Record analytics. UrlFetchApp.fetch('http://www.example.com/analytics?event=open'); } menu.addToUi(); }
Propiedades
Propiedad | Tipo | Descripción |
---|---|---|
NONE | Enum | Es un modo que no permite el acceso a ningún servicio que requiera autorización. Este modo ocurre cuando un complemento ejecuta un activador simple on y el usuario instaló un complemento en un documento diferente, pero no lo usó en el documento actual. |
CUSTOM_FUNCTION | Enum | Es un modo que permite el acceso a un subconjunto limitado de servicios para usarlos en funciones de hoja de cálculo personalizadas. Algunos de estos servicios, incluido el acceso de solo lectura al servicio de Hojas de cálculo, por lo general, requieren autorización, pero se permiten sin autorización cuando se usan en una función personalizada. Debido a que las funciones personalizadas no incluyen un parámetro de evento, este valor nunca se muestra; se documenta solo para demostrar que las funciones personalizadas se ejecutan en su propio modo de autorización. |
LIMITED | Enum | Es un modo que permite el acceso a un subconjunto limitado de servicios. Este modo ocurre cuando un complemento o una secuencia de comandos vinculada a un documento ejecuta un activador simple on o on , excepto en el caso descrito para NONE . |
FULL | Enum | Es un modo que permite el acceso a todos los servicios que requieren autorización. Este modo ocurre cuando se ejecuta un complemento o una secuencia de comandos como resultado de cualquier activador que no sea los casos descritos para LIMITED o NONE . |