Enum AuthMode

AuthMode

Una enumeración que identifica qué categorías de servicios autorizados puede Apps Script ejecutar a través de una función activada. Estos valores se exponen en las funciones activadas como authMode propiedad del parámetro de evento e. Para más información, consulta la guía del ciclo de vida de autorización de los 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) {
  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
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 se usó en el documento actual.
CUSTOM_FUNCTIONEnumEs un modo que permite acceder a un subconjunto limitado de servicios para usarlo en una hoja de cálculo personalizada. funciones. Algunos de estos servicios, como el acceso de solo lectura al servicio Spreadsheets, normalmente requieren autorización, pero se permiten sin autorización cuando se usan en una . Debido a que las funciones personalizadas no incluyen un parámetro del evento, este valor nunca se returned; sino que solo se documenta para demostrar que las funciones personalizadas se ejecutan en su propio el 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 La secuencia de comandos vinculada a un documento ejecuta un activador simple onOpen(e) o onEdit(e), excepto en el caso descrito en NONE.
FULLEnumEs un modo que permite el acceso a todos los servicios que requieren autorización. Este modo se produce cuando complemento o una secuencia de comandos se ejecuta como resultado de cualquier activador distinto de los casos descritos para LIMITED o NONE.