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 부가기능의 모양과 동작을 구성합니다. 이 필드를 생략하면 문서에서 부가기능이 사용 중지됩니다.

sheets

object (Sheets)

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

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

범용 액션

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

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