Package google.apps.script.type

색인

• AddOnWidgetSet(메시지)
• AddOnWidgetSet.WidgetType(열거형)
• CommonAddOnManifest(메시지)
• CreateActionExtensionPoint(메시지)
• HomepageExtensionPoint(메시지)
• HttpAuthorizationHeader(열거형)
• HttpOptions(메시지)
• LayoutProperties(메시지)
• LinkPreviewExtensionPoint(메시지)
• MenuItemExtensionPoint(메시지)
• UniversalActionExtensionPoint(메시지)
• UriPattern(메시지)

AddOnWidgetSet

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

필드
usedWidgets[]	WidgetType 부가기능에 사용되는 위젯 목록입니다.

WidgetType

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

열거형
WIDGET_TYPE_UNSPECIFIED	기본 위젯 세트입니다.
DATE_PICKER	날짜 선택 도구
STYLED_BUTTONS	스타일이 지정된 버튼에는 채워진 버튼과 비활성화된 버튼이 포함됩니다.
PERSISTENT_FORMS	영구 양식을 사용하면 작업 중에 양식 값을 유지할 수 있습니다.
FIXED_FOOTER	카드의 바닥글을 수정했습니다.
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 카드에 Material Design을 사용 설정합니다.

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이 사용됩니다.

MenuItemExtensionPoint

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

필드
runFunction	string 필수입니다. 이 확장 포인트가 활성화될 때 실행할 엔드포인트입니다.
label	string 필수입니다. 이 확장 포인트를 활성화하여 취해진 작업을 설명하는 사용자에게 표시되는 텍스트입니다. 예를 들어 '인보이스 삽입'이라고 입력합니다.
logoUrl	string 부가기능 툴바에 표시되는 로고 이미지의 URL입니다. 설정하지 않으면 기본값은 부가기능의 기본 로고 URL입니다.

UniversalActionExtensionPoint

범용 작업 메뉴 항목 확장 포인트를 선언하는 형식입니다.

필드
label	string 필수입니다. 이 확장 포인트를 활성화하여 취해진 작업을 설명하는 사용자에게 표시되는 텍스트입니다(예: '새 연락처 추가').
통합 필드 action_type. 필수입니다. 범용 작업 메뉴 항목에서 지원되는 작업 유형입니다. 열려는 링크 또는 실행할 엔드포인트일 수 있습니다. action_type은 다음 중 하나여야 합니다.
openLink	string UniversalAction에서 열 URL입니다.
runFunction	string UniversalAction에서 실행할 엔드포인트입니다.

UriPattern

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

필드
hostPattern	string 미리보기를 위해 각 URL 패턴에 필요합니다. URL 패턴의 도메인입니다. 부가기능은 URL에 이 도메인이 포함된 링크를 미리 봅니다. 특정 하위 도메인(예: subdomain.example.com)의 링크를 미리 보려면 하위 도메인을 포함하세요. 전체 도메인의 링크를 미리 보려면 하위 도메인으로 별표 (*)가 있는 와일드 카드 문자를 지정합니다. 예를 들어 *.example.com는 subdomain.example.com 및 another.subdomain.example.com와 일치합니다.
pathPrefix	string 선택사항입니다. hostPattern의 도메인을 추가하는 경로입니다. 예를 들어 URL 호스트 패턴이 support.example.com인 경우 support.example.com/cases/에 호스팅된 케이스의 URL과 일치시키려면 cases을 입력합니다. 호스트 패턴 도메인의 모든 URL과 일치시키려면 pathPrefix를 비워 둡니다.