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 ulteriori informazioni, consulta la guida al ciclo di vita delle autorizzazioni per i componenti aggiuntivi.

Per chiamare un'enumerazione, devi chiamare la classe, il nome e la proprietà principali. Ad esempio, 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();
}

Proprietà

Proprietà	Tipo	Descrizione
NONE	Enum	Una modalità che non consente l'accesso ai 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 personalizzate dei fogli di lavoro. Alcuni di questi servizi, incluso l'accesso di sola lettura al servizio Fogli di lavoro, di solito 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 propria 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 associato a un documento esegue un trigger 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 componente aggiuntivo o uno script viene eseguito come risultato di un trigger diverso dai casi descritti per LIMITED o NONE.