Enum AuthMode

AuthMode

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 funciones activadas como la authMode propiedad 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 enumeración, llama 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 se produce cuando un complemento ejecuta un onOpen(e) activador simple y el usuario instaló un complemento en un documento diferente, pero no se usó en el documento actual.
CUSTOM_FUNCTION	Enum	Es un modo que permite el acceso a un subconjunto limitado de servicios para usar 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, normalmente requieren autorización, pero se permiten sin autorización cuando se usan en una función personalizada. Como las funciones personalizadas no incluyen un parámetro de evento, nunca se muestra este valor. 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 se produce cuando un complemento o una secuencia de comandos vinculada a un documento ejecuta un onOpen(e) o onEdit(e) activador simple, 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 se produce cuando un complemento o una secuencia de comandos se ejecuta como resultado de cualquier activador que no sea el caso descrito para LIMITED o NONE.