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

속성

속성	유형	설명
NONE	Enum	승인이 필요한 서비스에 대한 액세스를 허용하지 않는 모드입니다. 이 모드는 부가기능이 onOpen(e) 단순 트리거를 실행하고 사용자가 다른 문서에 부가기능을 설치했지만 현재 문서에서 부가기능이 사용되지 않은 경우에 발생합니다.
CUSTOM_FUNCTION	Enum	맞춤 스프레드시트 함수에서 사용할 수 있는 제한된 서비스 하위 집합에 대한 액세스를 허용하는 모드입니다. 이러한 서비스 중 일부(예: 스프레드시트 서비스에 대한 읽기 전용 액세스)는 일반적으로 승인이 필요하지만 맞춤 함수에서 사용되는 경우에는 승인 없이 허용됩니다. 맞춤 함수에는 이벤트 매개변수가 포함되지 않으므로 이 값은 반환되지 않습니다. 맞춤 함수가 자체 승인 모드에서 실행된다는 것을 보여주기 위해서만 문서화됩니다.
LIMITED	Enum	제한된 서비스 하위 집합에 대한 액세스를 허용하는 모드입니다. 이 모드는 문서에 바인딩된 부가기능이나 스크립트가 NONE에 설명된 경우를 제외하고 onOpen(e) 또는 onEdit(e) 단순 트리거를 실행할 때 발생합니다.
FULL	Enum	승인이 필요한 모든 서비스에 대한 액세스를 허용하는 모드입니다. 이 모드는 LIMITED 또는 NONE에 설명된 사례 이외의 트리거의 결과로 부가기능이나 스크립트가 실행될 때 발생합니다.