Enum AuthMode

AuthMode

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 authMode del parámetro de evento, e. Para obtener más información, consulta la guía sobre el ciclo de vida de la autorización para complementos.

Para llamar a una enum, debes llamar a su clase superior, nombre y propiedad. Por ejemplo, ScriptApp.AuthMode.CUSTOM_FUNCTION.

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

PropiedadTipoDescripción
NONEEnumUn 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 otro documento, pero no se usó en el documento actual.
CUSTOM_FUNCTIONEnumEs un modo que permite el acceso a un subconjunto limitado de servicios para usar en funciones de hojas de cálculo personalizadas. Algunos de estos servicios, incluido el acceso de solo lectura al servicio de Hojas de cálculo, suelen requerir 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 se documenta para demostrar que las funciones personalizadas se ejecutan en su propio modo de autorización.
LIMITEDEnumEs 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.
FULLEnumEs 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 cualquier activador, excepto los casos descritos para LIMITED o NONE.