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

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

AddOns

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 부가기능의 모양 및 동작 구성입니다. 이 필드를 생략하면 부가기능이 프레젠테이션에서 사용 중지됩니다.

일반

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

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

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