부가기능 매니페스트 리소스

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

AddOns

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

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

object (Common)

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

calendar

object (Calendar)

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

chat

object ()

Google Workspace 부가기능이 Chat을 확장하는 경우 필요 Google Chat 앱의 구성입니다. 이 필드를 생략하면 Google Chat에서 부가기능이 사용 중지됩니다.

addOns.chat 객체는 비어 있어야 합니다. Chat에서 부가기능의 동작과 모양을 구성하려면 Google Chat 앱 구성을 참고하세요.
drive

object (Drive)

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

gmail

object (Gmail)

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

docs

object (Docs)

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

sheets

object (Sheets)

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

slides

object (Slides)

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

meet

object object (Meet)

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

일반

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

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입니다.

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

LayoutProperties

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

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

string

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

string

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

UniversalAction

유니버설 작업의 구성입니다. 선택하면 범용 작업이 지정된 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 함수의 이름입니다.

자세한 내용은 유니버설 작업 가이드를 참고하세요.