매니페스트 구조

이 페이지에서는 Google 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 앱은 사용자가 승인할 때까지 작업을 실행할 수 없습니다. 승인 전에 메시지를 게시하려면 매니페스트에 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)

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