Enum AuthMode

AuthMode

Énumération qui identifie les catégories de services autorisés qu'Apps Script peut exécuter via une fonction déclenchée. Ces valeurs sont exposées dans les fonctions déclenchées en tant que propriété authMode du paramètre d'événement, e. Pour en savoir plus, consultez le guide du cycle de vie de l'autorisation des modules complémentaires.

Pour appeler un énumération, vous devez appeler sa classe parente, son nom et sa propriété. Par exemple, 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();
}

Propriétés

Propriété	Type	Description
NONE	Enum	Mode qui n'autorise pas l'accès à des services nécessitant une autorisation. Ce mode se produit lorsqu'un module complémentaire exécute un déclencheur simple onOpen(e) et que l'utilisateur a installé un module complémentaire dans un autre document, mais que le module complémentaire n'a pas été utilisé dans le document actuel.
CUSTOM_FUNCTION	Enum	Mode qui permet d'accéder à un sous-ensemble limité de services à utiliser dans les fonctions de feuille de calcul personnalisées. Certains de ces services, y compris l'accès en lecture seule au service Sheets, nécessitent normalement une autorisation, mais sont autorisés sans autorisation lorsqu'ils sont utilisés dans une fonction personnalisée. Étant donné que les fonctions personnalisées n'incluent pas de paramètre d'événement, cette valeur n'est jamais renvoyée. Elle n'est documentée que pour démontrer que les fonctions personnalisées s'exécutent dans leur propre mode d'autorisation.
LIMITED	Enum	Mode qui permet d'accéder à un sous-ensemble limité de services. Ce mode se produit lorsqu'un module complémentaire ou un script lié à un document exécute un déclencheur simple onOpen(e) ou onEdit(e), sauf dans le cas décrit pour NONE.
FULL	Enum	Mode qui permet d'accéder à tous les services nécessitant une autorisation. Ce mode se produit lorsqu'un module complémentaire ou un script s'exécute en raison de tout déclencheur autre que les cas décrits pour LIMITED ou NONE.