Enum AuthMode

Modo de autenticación

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 authMode 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

PropiedadTipoDescripción
NONEEnumEs 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 onOpen(e) y el usuario instaló un complemento en un documento diferente, pero no lo usó en el documento actual.
CUSTOM_FUNCTIONEnumEs 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.
LIMITEDEnumEs 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 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 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.