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 auth
do parâmetro de evento, e
. Para
mais informações, consulte o guia do
ciclo de vida de autorização para complementos.
Para chamar um tipo enumerado, chame a classe mãe, o nome e a propriedade dele. 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 acesso a serviços que exigem autorização. Esse modo ocorre
quando um complemento executa um acionador simples on e o usuário instalou um
complemento em um documento diferente, mas o complemento 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 de planilha personalizadas. Alguns desses serviços, incluindo o acesso de leitura somente 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 acionador simples on ou on , 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, exceto os casos descritos para
LIMITED ou NONE . |