Enum AuthMode

AuthMode

Uma enumeração que identifica quais categorias de serviços autorizados o Apps Script pode executar usando uma função acionada. Esses valores são expostos em funções acionadas como a propriedade authMode do parâmetro de evento, e. Para mais informações, consulte o guia sobre o ciclo de vida de autorização para complementos.

Para chamar uma enumeração, chame a classe mãe, o nome e a propriedade dela. Por exemplo, 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();
}

Propriedades

Propriedade	Tipo	Descrição
NONE	Enum	Um modo que não permite o acesso a nenhum serviço que exija autorização. Esse modo ocorre quando um complemento executa um acionador simples onOpen(e) e o usuário instalou um complemento em um documento diferente, mas ele não foi usado no documento atual.
CUSTOM_FUNCTION	Enum	Um modo que permite o acesso a um subconjunto limitado de serviços para uso em funções personalizadas de planilhas. Alguns desses serviços, incluindo o acesso somente leitura ao serviço de planilhas, normalmente exigem autorização, mas são permitidos sem autorização quando usados em uma função personalizada. Como as funções personalizadas não incluem um parâmetro de evento, esse valor nunca é retornado. Ele é documentado apenas para demonstrar que as funções personalizadas são executadas no próprio modo de autorização.
LIMITED	Enum	Um modo que permite o acesso a um subconjunto limitado de serviços. Esse modo ocorre quando um complemento ou um script vinculado a um documento executa um gatilho simples onOpen(e) ou onEdit(e), exceto no caso descrito para NONE.
FULL	Enum	Um modo que permite o acesso a todos os serviços que exigem autorização. Esse modo ocorre quando um complemento ou um script é executado como resultado de qualquer acionador diferente dos casos descritos para LIMITED ou NONE.