Enum AuthMode

AuthMode

トリガーされた関数を介して Apps Script が実行できる承認済みサービスのカテゴリを識別する列挙型。これらの値は、トリガー関数で、イベント パラメータ e の authMode プロパティとして公開されます。詳しくは、アドオンの認証ライフサイクルに関するガイドをご覧ください。

列挙型を呼び出すには、親クラス、名前、プロパティを呼び出します。たとえば、 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();
}

プロパティ

プロパティタイプ説明
NONEEnum認証が必要なサービスへのアクセスを許可しないモード。このモードは、アドオンが onOpen(e) シンプル トリガーを実行し、ユーザーが別のドキュメントにアドオンをインストールしているものの、そのアドオンが現在のドキュメントで使用されていない場合に発生します。
CUSTOM_FUNCTIONEnumカスタム スプレッドシート関数で使用するために、サービスの限定されたサブセットへのアクセスを許可するモード。これらのサービスの一部（スプレッドシート サービスへの読み取り専用アクセスなど）は、通常は承認が必要ですが、カスタム関数で使用する場合は承認なしで許可されます。カスタム関数にはイベント パラメータが含まれていないため、この値が返されることはありません。これは、カスタム関数が独自の承認モードで実行されることを示すためにのみ記載されています。
LIMITEDEnumサービスの限定されたサブセットへのアクセスを許可するモード。このモードは、NONE で説明されている場合を除き、ドキュメントにバインドされたアドオンまたはスクリプトが onOpen(e) または onEdit(e) のシンプルな トリガーを実行するときに発生します。
FULLEnum認可が必要なすべてのサービスへのアクセスを許可するモード。このモードは、LIMITED または NONE で説明したケース以外のトリガーの結果としてアドオンまたはスクリプトが実行された場合に発生します。