Una enumeración que identifica las categorías de servicios autorizados que Apps Script puede ejecutar a través de una función activada. Estos valores se exponen en funciones activadas como la propiedad authMode
del parámetro del evento, e
. Si deseas obtener más información, consulta la guía del ciclo de vida de la autorización para complementos.
function onOpen(e) { var 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). var properties = PropertiesService.getDocumentProperties(); var 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 | Un modo que no permite el acceso a ningún servicio que requiera autorización. Este modo se produce cuando un complemento ejecuta un activador simple onOpen(e) y el usuario instaló un complemento en un documento diferente, pero no se usó en el documento actual. |
CUSTOM_FUNCTION | Enum | Un modo que permite el acceso a un subconjunto limitado de servicios para su uso en funciones personalizadas de hojas de cálculo. 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; solo está documentado para demostrar que las funciones personalizadas se ejecutan en su propio modo de autorización. |
LIMITED | Enum | Un modo que permite el acceso a un subconjunto limitado de servicios. Este modo se produce cuando un complemento o una secuencia de comandos vinculada a un documento ejecuta un activador simple onOpen(e) o onEdit(e) , excepto en el caso descrito para NONE . |
FULL | Enum | Un modo que permite el acceso a todos los servicios que requieren autorización. Este modo se produce cuando se ejecuta un complemento o una secuencia de comandos como resultado de un activador que no sea el de los casos descritos para LIMITED o NONE . |