Package google.apps.script.type

색인

AddOnWidgetSet

부가기능에서 사용하는 위젯 하위 집합입니다.

입력란
usedWidgets[]

WidgetType

부가기능에서 사용되는 위젯 목록입니다.

WidgetType

위젯 유형입니다. WIDGET_TYPE_UNSPECIFIED는 기본 위젯 세트입니다.

열거형
WIDGET_TYPE_UNSPECIFIED 기본 위젯 세트입니다.
DATE_PICKER 날짜 선택 도구
STYLED_BUTTONS 스타일이 지정된 버튼에는 채워진 버튼과 비활성화된 버튼이 포함됩니다.
PERSISTENT_FORMS 영구 양식을 사용하면 작업 중에 양식 값을 유지할 수 있습니다.
UPDATE_SUBJECT_AND_RECIPIENTS 임시보관 메일의 제목과 수신자를 업데이트합니다.
GRID_WIDGET 그리드 위젯
ADDON_COMPOSE_UI_ACTION 부가기능 편지쓰기 UI에 적용되는 Gmail 부가기능입니다.

CommonAddOnManifest

모든 부가기능 호스트 애플리케이션에서 공유되는 부가기능 구성입니다.

입력란
name

string

필수 항목입니다. 부가기능의 표시 이름입니다.

logoUrl

string

필수 항목입니다. 부가기능 툴바에 표시된 로고 이미지의 URL입니다.

layoutProperties

LayoutProperties

부가기능 카드의 일반적인 레이아웃 속성입니다.

addOnWidgetSet

AddOnWidgetSet

부가기능에 사용된 위젯입니다. 이 필드를 지정하지 않으면 기본 세트가 사용됩니다.

useLocaleFromApp

bool

호스트 앱에서 언어 정보를 전달할지 여부입니다.

homepageTrigger

HomepageExtensionPoint

모든 컨텍스트, 모든 호스트에서 실행될 엔드포인트를 정의합니다. 이 기능으로 생성된 모든 카드는 사용자가 항상 사용할 수 있지만 이 부가기능이 더 타겟팅된 트리거를 선언하는 경우 문맥 콘텐츠에 의해 가려질 수 있습니다.

universalActions[]

UniversalActionExtensionPoint

부가기능의 설정 메뉴 역할을 하는 범용 작업 메뉴에서 확장 지점 목록을 정의합니다. 확장 지점은 열 링크 URL 또는 양식 제출로 실행할 엔드포인트일 수 있습니다.

openLinkUrlPrefixes

ListValue

OpenLink 작업은 HTTPS, MAILTO 또는 TEL 스키마가 포함된 URL만 사용할 수 있습니다. HTTPS 링크의 경우 URL이 허용 목록에 지정된 접두사 중 하나와 일치해야 합니다. 접두사에 스키마가 생략되면 HTTPS로 간주됩니다. HTTP 링크가 HTTPS 링크로 자동 재작성됩니다.

CreateActionExtensionPoint

사용자가 Google Workspace 애플리케이션에서 리소스 생성 워크플로를 호출할 때 실행되는 트리거의 구성입니다. 자세한 내용은 @ 메뉴에서 서드 파티 리소스 만들기를 참고하세요.

입력란
id

string

필수 항목입니다. 이 확장 지점을 구별하기 위한 고유 ID입니다. ID는 최대 64자(영문 기준)까지 허용되며 [a-zA-Z0-9-]+ 형식이어야 합니다.

labelText

string

필수 항목입니다. 리소스 생성 진입점의 아이콘과 함께 표시되는 텍스트입니다(예: Create support case). 이 텍스트는 정적이며 사용자가 부가기능을 실행하기 전에 표시됩니다.

localizedLabelText

map<string, string>

선택사항입니다. 다른 언어로 현지화할 labelText의 지도입니다. ISO 639의 언어와 ISO 3166의 국가/지역 형식을 하이픈 -으로 구분하여 지정합니다. 예: en-US

사용자의 언어가 지도의 키에 있으면 사용자에게는 현지화된 labelText 버전이 표시됩니다.

runFunction

string

필수 항목입니다. 리소스 생성 워크플로가 트리거되어 링크를 만들 때 실행할 엔드포인트입니다.

logoUrl

string

선택사항입니다. 리소스 생성 진입점에 표시되는 아이콘입니다. 생략하면 메뉴에 부가기능 툴바 아이콘 logoUrl이 사용됩니다.

HomepageExtensionPoint

부가기능의 홈페이지 뷰를 선언하는 일반적인 형식입니다.

입력란
runFunction

string

필수 항목입니다. 이 확장 지점이 활성화될 때 실행할 엔드포인트입니다.

enabled

BoolValue

선택사항입니다. false로 설정하면 이 컨텍스트에서 홈페이지 뷰가 비활성화됩니다.

설정하지 않으면 기본값은 true입니다.

부가기능의 맞춤 홈페이지 뷰가 사용 중지된 경우 대신 사용자에게 일반 개요 카드가 제공됩니다.

HttpAuthorizationHeader

부가기능 HTTP 요청에서 승인 헤더가 전송되었습니다.

열거형
HTTP_AUTHORIZATION_HEADER_UNSPECIFIED 기본값입니다. SYSTEM_ID_TOKEN와 같습니다.
SYSTEM_ID_TOKEN 프로젝트별 Google Workspace 부가기능 시스템 서비스 계정 (기본값)의 ID 토큰을 전송합니다.
USER_ID_TOKEN 최종 사용자의 ID 토큰을 전송합니다.
NONE 인증 헤더를 전송하지 않습니다.

HttpOptions

부가기능 HTTP 엔드포인트에 요청을 전송하는 옵션입니다.

입력란
authorizationHeader

HttpAuthorizationHeader

HTTP 승인 헤더에 전송된 토큰의 구성입니다.

LayoutProperties

모든 부가기능 호스트 애플리케이션에서 공유되는 카드 레이아웃 속성입니다.

입력란
primaryColor

string

부가기능의 기본 색상입니다. 툴바의 색상을 설정합니다. 기본 색상이 설정되지 않은 경우 프레임워크에서 제공하는 기본값이 사용됩니다.

secondaryColor

string

부가기능의 보조 색상입니다. 버튼의 색상을 설정합니다. 기본 색상은 설정되었지만 보조 색상이 설정되지 않은 경우 보조 색상은 기본 색상과 동일합니다. 기본 색상과 보조 색상이 모두 설정되어 있지 않으면 프레임워크에서 제공하는 기본값이 사용됩니다.

useNewMaterialDesign

bool

카드에 머티리얼 디자인을 사용합니다.

LinkPreviewExtensionPoint

사용자가 서드 파티 또는 Google 이외의 서비스의 링크를 Google Docs, Sheets, Slides 파일에 입력하거나 붙여넣을 때 실행되는 트리거의 구성입니다.

입력란
labelText

string

필수 항목입니다. 사용자에게 링크를 미리 보라는 메시지를 표시하는 스마트 칩 예시의 텍스트입니다(예: Example: Support case). 이 텍스트는 정적이며 사용자가 부가기능을 실행하기 전에 표시됩니다.

localizedLabelText

map<string, string>

선택사항입니다. 다른 언어로 현지화할 labelText의 지도입니다. ISO 639의 언어와 ISO 3166의 국가/지역 형식을 하이픈 -으로 구분하여 지정합니다. 예: en-US

사용자의 언어가 지도의 키에 있으면 사용자에게는 현지화된 labelText 버전이 표시됩니다.

patterns[]

UriPattern

필수 항목입니다. 미리보기 링크에 부가기능을 트리거하는 URL 패턴의 배열입니다.

runFunction

string

필수 항목입니다. 링크 미리보기가 트리거될 때 실행할 엔드포인트입니다.

logoUrl

string

선택사항입니다. 스마트 칩 및 미리보기 카드에 표시되는 아이콘 생략하면 부가기능은 툴바 아이콘 logoUrl을 사용합니다.

호스트 앱 내에 표시되는 메뉴 항목 또는 버튼을 선언하는 일반적인 형식입니다.

입력란
runFunction

string

필수 항목입니다. 이 확장 지점이 활성화될 때 실행할 엔드포인트입니다.

label

string

필수 항목입니다. 이 확장 지점을 활성화하여 실행한 작업을 설명하는, 사용자에게 표시되는 텍스트입니다. 예: '인보이스 삽입'

logoUrl

string

부가기능 툴바에 표시된 로고 이미지의 URL입니다.

설정하지 않으면 부가기능의 기본 로고 URL이 기본값으로 사용됩니다.

UniversalActionExtensionPoint

범용 작업 메뉴 항목 확장 지점을 선언하는 형식입니다.

입력란
label

string

필수 항목입니다. 이 확장 지점을 활성화하여 수행한 작업을 설명하는 사용자 표시 텍스트입니다(예: '새 연락처 추가').

통합 필드 action_type. 필수 항목입니다. 범용 작업 메뉴 항목에서 지원되는 작업 유형입니다. 열려는 링크 또는 실행할 엔드포인트일 수 있습니다. action_type은 다음 중 하나여야 합니다.
runFunction

string

UniversalAction에서 실행할 엔드포인트입니다.

UriPattern

링크 미리보기를 트리거하는 각 URL 패턴의 구성입니다.

입력란
hostPattern

string

미리 볼 각 URL 패턴에 필요합니다. URL 패턴의 도메인입니다. 부가기능 미리보기 링크는 URL에 이 도메인이 포함된 링크입니다. 특정 하위 도메인(예: subdomain.example.com)의 링크를 미리 보려면 하위 도메인을 포함하세요. 전체 도메인의 링크를 미리 보려면 하위 도메인으로 별표 (*)와 함께 와일드 카드 문자를 지정합니다.

예를 들어 *.example.comsubdomain.example.comanother.subdomain.example.com와 일치합니다.

pathPrefix

string

선택사항입니다. hostPattern의 도메인을 추가하는 경로입니다.

예를 들어 URL 호스트 패턴이 support.example.com인 경우 support.example.com/cases/에서 호스팅되는 케이스의 URL과 일치시키려면 cases을 입력합니다.

호스트 패턴 도메인의 모든 URL과 일치시키려면 pathPrefix을 비워 두세요.