매니페스트 구조

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

매니페스트의 하위 구조는 별도의 페이지에 정의됩니다.

매니페스트

매니페스트 구성의 최상위 수준입니다.

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

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

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

        "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') 중 하나의 script time zone입니다.

urlFetchWhitelist[]

string

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

webapp

object (Webapp)

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