매니페스트 구조

이 페이지에서는 Apps Script 프로젝트의 매니페스트 파일 JSON 데이터 구조의 최상위 수준을 설명합니다. 매니페스트는 Apps Script 프로젝트의 기능 또는 목적을 정의합니다.

JSON 표현 
{
  "addOns": {
    object (AddOns)
  },
  "chat": {},
  "dependencies": {
    object (Dependencies)
  },
  "exceptionLogging": string,
  "executionApi": {
    object (ExecutionApi)
  },
  "oauthScopes": [
    string
  ],
  "runtimeVersion": string,
  "sheets": {
    object (Sheets)
  },
  "timeZone": string,
  "urlFetchWhitelist": [
    string
  ],
  "webapp": {
    object (Webapp)
  }
}
필드
addOns

object (AddOns)

Google Workspace 부가기능으로 배포된 경우 프로젝트의 리소스 구성입니다.

chat

object

Google Chat 앱으로 배포된 경우 프로젝트의 구성입니다.

참고: 새 Chat 앱의 경우 addOns.chat 필드를 대신 사용하는 것이 좋습니다. chat 필드를 사용하는 기존 Chat 앱을 유지관리하는 경우 빈 객체여야 합니다.

Chat 앱의 세부정보를 구성하려면 Google Chat API를 사용 설정해야 합니다. 자세한 내용은 Google Chat API 구성을 참고하세요.

Apps Script는 스크립트 수준에서 승인을 처리합니다. 승인이 필요한 Chat 앱은 사용자가 Chat 앱을 승인할 때까지 어떤 작업도 실행할 수 없습니다. 승인 전에 메시지를 게시하려면 매니페스트에 addToSpaceFallbackMessage 객체를 추가하면 됩니다. Chat 앱에 초기화 로직이 필요한 경우 onMessage 작업에서 이 로직을 복제해야 할 수 있습니다.

다음 예에서는 사용자가 채팅 스페이스에 추가할 때 기본 환영 메시지로 응답하는 채팅 앱을 보여줍니다.

        "chat": {
          "addToSpaceFallbackMessage": "Thank you for adding me!"
        }

dependencies

object (Dependencies)

스크립트 프로젝트에서 사용할 수 있도록 설정된 고급 서비스 및 라이브러리의 구성입니다.

exceptionLogging

string

예외가 로깅되는 위치입니다. 유효한 설정은 다음과 같습니다.

  • NONE은 예외가 로깅되지 않음을 나타냅니다.
  • STACKDRIVER는 예외가 Stackdriver에 로깅됨을 나타냅니다.
executionApi

object (ExecutionApi)

스크립트 프로젝트의 API 실행 파일 구성입니다. 이 값은 프로젝트가 API 실행을 위해 배포된 경우에만 사용됩니다.

oauthScopes[]

string

스크립트 프로젝트에서 사용하는 승인 범위의 정의입니다.

runtimeVersion

string

스크립트에서 사용하는 런타임 버전입니다. 이 필드가 매니페스트에 없으면 스크립트에서 기본 런타임 (STABLE)을 사용합니다. 이 필드의 유효한 옵션은 다음과 같습니다.

  • STABLE는 기본 런타임(현재 Rhino)을 나타냅니다.
  • V8은 V8 기반 런타임을 나타냅니다.
  • DEPRECATED_ES5는 Rhino 런타임을 나타냅니다. 이 값을 설정하면 V8로의 자동 이전도 방지됩니다.
sheets

object (Sheets)

Sheets 매크로를 정의하는 리소스 구성입니다.

timeZone

string

사용 가능한 ZoneId 값 중 하나에 있는 스크립트 시간대(예: 'America/Denver')
urlFetchWhitelist[]

string

HTTPS URL 접두사 목록입니다. 있는 경우 가져온 URL 엔드포인트는 이 목록의 접두사 중 하나와 일치해야 합니다. 이렇게 하면 사용자 데이터를 보호할 수 있습니다. 이 필드는 테스트 배포에서는 선택사항이지만 배포에서는 필수입니다. URL 허용 목록에 추가하기에 대해 자세히 알아보세요.

webapp

object (Webapp)

스크립트 프로젝트의 웹 앱 구성입니다. 프로젝트가 웹 앱으로 배포된 경우에만 사용됩니다.