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

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)
  }
}
필드
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에서 부가기능의 동작 및 모양을 구성하려면 Chat 앱 구성을 참고하세요.

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

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

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 함수의 이름입니다.

자세한 내용은 universal actions 가이드를 참고하세요.