Enum AuthMode

AuthMode

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

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

Propriétés

PropriétéTypeDescription
NONEEnumMode qui n'autorise pas l'accès aux services nécessitant une autorisation. Ce mode est activé Lorsqu'un module complémentaire exécute un déclencheur simple onOpen(e) et que l'utilisateur a installé un dans un autre document, mais qui n'a pas été utilisé dans le document actuel.
CUSTOM_FUNCTIONEnumMode permettant d'accéder à un sous-ensemble limité de services à utiliser dans une feuille de calcul personnalisée fonctions. Certains de ces services, y compris l'accès en lecture seule au service Spreadsheet, requièrent normalement une autorisation, mais sont autorisées sans autorisation lorsqu'elles sont utilisées dans un . Étant donné que les fonctions personnalisées n'incluent pas de paramètre d'événement, cette valeur n'est jamais returned; mais seulement pour démontrer que les fonctions personnalisées s'exécutent mode d'autorisation.
LIMITEDEnumMode permettant l'accès à un sous-ensemble limité de services. Ce mode se produit lorsqu'un module complémentaire ou script lié à un document exécute un déclencheur simple onOpen(e) ou onEdit(e), sauf dans le cas décrit pour NONE.
FULLEnumUn mode qui permet d'accéder à tous les services nécessitant une autorisation. Ce mode se produit lorsqu'un ou un script s'exécute suite à un déclencheur autre que les cas décrits pour LIMITED ou NONE.