Enum AuthMode

AuthMode

Un'enumerazione che identifica le categorie di servizi autorizzati che Apps Script è in grado di eseguire tramite una funzione attivata. Questi valori sono esposti nelle funzioni attivate come proprietà authMode del parametro evento e. Per maggiori informazioni, consulta la guida al ciclo di vita dell'autorizzazione per i componenti aggiuntivi.

Per chiamare un enum, devi chiamare la relativa classe, il nome e la proprietà di base. Ad esempio, 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();
}

Proprietà

Proprietà	Tipo	Descrizione
NONE	Enum	Una modalità che non consente l'accesso a servizi che richiedono l'autorizzazione. Questa modalità si verifica quando un componente aggiuntivo esegue un trigger semplice onOpen(e) e l'utente ha installato un componente aggiuntivo in un altro documento, ma il componente aggiuntivo non è stato utilizzato nel documento corrente.
CUSTOM_FUNCTION	Enum	Una modalità che consente l'accesso a un sottoinsieme limitato di servizi da utilizzare nelle funzioni di un foglio di lavoro personalizzato. Alcuni di questi servizi, tra cui l'accesso di sola lettura al servizio Fogli, normalmente richiedono l'autorizzazione, ma sono consentiti senza autorizzazione se utilizzati in una funzione personalizzata. Poiché le funzioni personalizzate non includono un parametro evento, questo valore non viene mai restituito. È documentato solo per dimostrare che le funzioni personalizzate vengono eseguite nella loro modalità di autorizzazione.
LIMITED	Enum	Una modalità che consente l'accesso a un sottoinsieme limitato di servizi. Questa modalità si verifica quando un componente aggiuntivo o uno script legato a un documento esegue un attivatore semplice onOpen(e) o onEdit(e), tranne nel caso descritto per NONE.
FULL	Enum	Una modalità che consente l'accesso a tutti i servizi che richiedono l'autorizzazione. Questa modalità si verifica quando un plug-in o uno script viene eseguito come risultato di qualsiasi attivatore diverso dai casi descritti per LIMITED o NONE.