Enum AuthMode

AuthMode

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

Per chiamare un'enumerazione, chiama la classe padre, il nome e la proprietà. 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 nessun servizio che richiede l'autorizzazione. Questa modalità si verifica quando un componente aggiuntivo esegue un onOpen(e) trigger semplice 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, in genere richiedono l'autorizzazione, ma sono consentiti senza autorizzazione quando vengono utilizzati in una funzione personalizzata. Poiché le funzioni personalizzate non includono un parametro evento, questo valore non viene mai restituito; viene 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 onOpen(e) o onEdit(e) trigger semplice, 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 in seguito a un trigger diverso dai casi descritti per LIMITED o NONE.