AddOns 매니페스트 리소스

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Google Workspace 부가기능 콘텐츠 및 동작을 정의하는 데 사용되는 리소스 구성입니다. Google Workspace 부가기능 매니페스트에는 필수로 표시된 모든 구성요소가 있어야 합니다.

부가기능

Google Workspace 부가기능 매니페스트 구성의 최상위 수준

JSON 표현
{
  "common": {
    object (Common)
  },
  "calendar": {
    object (Calendar)
  },
  "drive": {
    object (Drive)
  },
  "gmail": {
    object (Gmail)
  },
  "docs": {
    object (Docs)
  },
  "sheets": {
    object (Sheets)
  },
  "slides": {
    object (Slides)
  }
}
필드
common

object (Common)

필수. 모든 호스트 애플리케이션에 공통된 Google Workspace 부가기능 값을 정의합니다. 여기에 정의된 일부 값은 특정 호스트의 특정 값이 생략된 경우 기본값으로 사용됩니다.

calendar

object (Calendar)

Google Workspace 부가기능이 Calendar를 확장하는 경우 필수 Google Calendar 호스트 애플리케이션 내에서 Google Workspace 부가기능 모양 및 동작을 구성합니다. 이 필드를 생략하면 Google Calendar에서 부가기능이 사용 중지됩니다.

drive

object (Drive)

Google Workspace 부가기능이 Google Drive를 확장하는 경우 필수 Google Drive 호스트 애플리케이션 내에서 Google Workspace 부가기능 모양 및 동작을 구성합니다. 이 필드를 생략하면 Google Drive에서 부가기능이 사용 중지됩니다.

gmail

object (Gmail)

Google Workspace 부가기능이 Gmail을 확장하는 경우 필수 Gmail 호스트 애플리케이션 내에서 Google Workspace 부가기능 모양 및 동작을 구성합니다. 이 필드를 생략하면 부가기능이 Gmail에서 사용 중지됩니다.

docs

object (Docs)

Google Workspace 부가기능이 Docs를 확장하는 경우 필요 Docs 호스트 애플리케이션 내에서 Google Workspace 부가기능의 모양과 동작을 구성합니다. 이 필드를 생략하면 Docs에서 부가기능이 사용 중지됩니다.

sheets

object (Sheets)

Google Workspace 부가기능이 Sheets를 확장하는 경우 필수 Sheets 호스트 애플리케이션 내에서 Google Workspace 부가기능의 모양 및 동작 구성 이 필드를 생략하면 Sheets에서 부가기능이 사용 중지됩니다.

slides

object (Slides)

Google Workspace 부가기능이 Slides를 확장하는 경우 필요 Slides 호스트 애플리케이션 내에서 Google Workspace 부가기능의 모양 및 동작 구성 이 필드를 생략하면 Slides에서 부가기능이 사용 중지됩니다.

일반

모든 호스트 애플리케이션에 공통적인 매개변수의 매니페스트 구성입니다. 여기에 정의된 일부 값은 특정 호스트의 특정 값이 생략된 경우 기본값으로 사용됩니다.

JSON 표현
{
  "homepageTrigger": {
    object (HomepageTrigger)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "logoUrl": string,
  "name": string,
  "openLinkUrlPrefixes": [
    string
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "useLocaleFromApp": boolean
}
필드
homepageTrigger

object (HomepageTrigger)

부가기능 홈페이지를 만들기 위한 기본 트리거 함수 사양입니다. 이 사양은 호스트별 홈페이지 트리거가 정의되지 않은 경우 사용됩니다. 이 또한 생략되면 일반 홈페이지 카드가 생성되어 필요할 때 사용됩니다.
layoutProperties

object (LayoutProperties)

부가기능 툴바와 버튼에 사용되는 색상에 관한 구성입니다.
logoUrl

string

필수. 툴바에 표시된 이미지의 URL입니다. URL은 공개 상태여야 합니다.

name

string

필수. 툴바에 표시된 부가기능의 이름입니다.

openLinkUrlPrefixes[]

string

부가기능에서 OpenLink를 사용하는 위젯 내에서 또는 HTML 앵커 태그를 사용하는 텍스트 위젯 내에서 아웃바운드 링크를 표시하는 경우에 필요합니다. HTTPS URL 프리픽스 목록입니다. 사용자 데이터를 보호하려면 부가기능에서 렌더링하는 모든 링크는 이 목록의 프리픽스 중 하나와 일치해야 합니다.

자세한 내용은 허용 목록 URL을 참고하세요.

universalActions[]

object (UniversalAction)

부가기능 UI에서 항상 사용할 수 있는 범용 작업 목록입니다.
useLocaleFromApp

boolean

true인 경우 작업 콜백 함수 또는 트리거 함수에 전달된 부가기능 이벤트 객체에는 사용자의 언어 및 시간대 정보가 포함됩니다. 기본값은 false입니다.

자세한 내용은 사용자 언어 및 시간대 액세스를 참고하세요.

레이아웃 속성

부가기능 툴바와 버튼 색상 및 모양을 제어하는 Google Workspace 구성입니다.

JSON 표현
{
  "primaryColor": string,
  "secondaryColor": string
}
필드
primaryColor

string

툴바의 색상입니다. 기본값은 회색 (#424242)입니다.
secondaryColor

string

버튼의 기본 색상입니다. 기본값은 기본 색상 (설정된 경우)이고 그렇지 않은 경우 파란색 (#2196F3)으로 기본 설정됩니다.

유니버설 액션

범용 작업 구성입니다. 이 작업을 선택하면 범용 작업이 지정된 URL 링크를 열거나 지정된 Apps Script 함수를 실행합니다.

JSON 표현
{
  "label": string,

  // Union field rule can be only one of the following:
  "openLink": string,
  "runFunction": string,
  // End of list of possible types for union field rule.

}
필드
label

string

각 범용 작업에 필요합니다. 이 작업의 UI 메뉴에 표시되는 텍스트입니다.
runFunction

string

openLink가 없는 경우 각 범용 작업에 필요합니다. 제공되는 경우 사용자가 이 작업을 선택할 때 실행되는 Apps Script 함수의 이름입니다.

자세한 내용은 범용 작업 가이드를 참고하세요.