このページは Cloud Translation API によって翻訳されました。

Enum 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();
}

プロパティ

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