AddOns Response Service

부가기능 응답 서비스

이 서비스를 사용하면 스크립트가 Google Workspace Studio를 확장하는 Google Workspace 부가기능을 구성하고 빌드할 수 있습니다.

클래스

이름간략한 설명
ActionGoogle Workspace Studio를 확장하는 Google Workspace 부가기능이 새 카드를 렌더링하는 데 사용할 수 있는 작업입니다.
AddOnsResponseServiceAddOnsResponseService는 Google Workspace Studio를 확장하는 Google Workspace 부가기능의 응답을 만드는 기능을 제공합니다.
BasicDataType기본 일반 데이터 유형을 나타내는 열거형입니다.
ColorRGBA 색상 공간의 색상을 나타내는 Color 객체입니다.
DataTypeDataType은 변수의 유형을 설정하는 데 사용됩니다.
DynamicResourceDefinitionDynamicResourceDefinition은 ResourceFieldsDefinitionRetrievedAction의 빌딩 블록으로, 하나 이상의 ResourceField을 포함하여 Google Workspace Studio의 단계에서 제공하는 출력 변수의 수를 동적으로 정의할 수 있습니다.
ErrorActionability오류 조치 가능성을 나타내는 Enum입니다.
ErrorRetryability오류가 있을 때 작업 호출의 재시도 가능성을 나타내는 열거형입니다.
FontWeight스타일이 지정된 텍스트의 글꼴 두께를 나타내는 열거형입니다.
HostAppActionHostAppAction은 개별 호스트 앱에서 처리하는 작업 유형입니다.
HyperlinkTextFormatElement에서 사용되는 하이퍼링크 요소입니다.
InsertSectionInsertSection 객체의 빌더입니다.
InsertWidgetInsertWidget 객체의 빌더입니다.
Link호스트 애플리케이션에서 스마트 칩으로 변환되는 서드 파티 리소스의 링크 객체입니다.
ListContainer목록 항목의 컨테이너로, 각 목록 항목에는 여러 TextFormatElement가 포함될 수 있습니다.
ListItem목록 항목입니다. 각 목록 항목에는 여러 TextFormatElement가 포함될 수 있습니다.
ListType목록 유형을 나타내는 열거형입니다.
ModifyCardModifyCard 객체를 Action에 전달하여 기존 카드의 인터페이스를 변경하고 업데이트하는 ModifyCard 객체의 빌더입니다.
Navigation카드 탐색을 제어하는 도우미 객체입니다.
RemoveSectionRemoveSection 객체의 빌더입니다.
RemoveWidgetRemoveWidget 객체의 빌더입니다.
RenderAction사용자 상호작용에 응답하여 Action을 실행하여 카드를 렌더링하거나 업데이트합니다.
RenderActionBuilderRenderAction 객체의 빌더입니다.
ResourceData애플리케이션별 리소스 데이터를 나타냅니다. 리소스 데이터에는 변수 이름과 VariableData의 키-값 쌍 컬렉션이 포함됩니다.
ResourceFieldResourceField는 DynamicResourceDefinition의 기본 구성요소이며 각 리소스 필드는 현재 단계의 출력 변수에 해당합니다.
ResourceFieldsDefinitionRetrievedActionResourceFieldsDefinitionRetrievedAction는 매니페스트에 지정된 dynamicResourceDefinitionProvider 함수를 통해 리소스 필드 목록의 정의를 검색하는 데 사용되는 ResourceFieldsDefinitionRetrievedAction 유형입니다.
ResourceRetrievedActionResourceRetrievedAction은 필요할 때 맞춤 리소스 콘텐츠를 검색하는 데 사용되며, 맞춤 리소스 필드는 ResourceData에 정의됩니다.
ResourceType애플리케이션별 리소스 유형입니다. 리소스 유형의 고유 식별자에는 해당 WorkflowResourceDefinition이 있어야 합니다.
ReturnElementErrorActionReturnElementErrorAction은 요소 호출 중에 오류가 발생했음을 나타냅니다.
ReturnOutputVariablesActionGoogle Workspace Studio에서 실행된 작업에 의해 생성된 출력 변수를 포함합니다.
SaveWorkflowAction이 작업은 호스트 앱 (Google Workspace Studio)이 에이전트를 저장해야 함을 나타냅니다.
StyledText굵게, 기울임꼴, 색상과 같은 스타일이 적용된 텍스트 요소
TextFormatChip텍스트 형식의 클릭 가능한 칩입니다.
TextFormatElement텍스트 형식 요소로, TextFormatChip, StyledText, Hyperlink 또는 ListContainer일 수 있습니다.
TextFormatIconTextFormatChip에 표시되는 아이콘입니다.
TextStyle스타일이 지정된 텍스트의 스타일을 나타내는 enum입니다.
TimeStampVariableData에 추가할 수 있는 타임스탬프 객체를 나타냅니다.
UpdateWidgetUpdateWidget 객체의 빌더입니다.
ValidationErrorSeverity유효성 검사 오류의 심각도를 나타내는 enum입니다.
ValueMetadatavalueMetadata에는 변수의 잠재적 값에 관한 정보가 포함됩니다.
VariableData다양한 유형의 값 모음을 포함할 수 있는 변수 데이터를 나타냅니다.
WorkflowActionWorkflowAction은 Google Workspace Studio에서 특정 작업을 실행하는 데 사용되는 HostAppAction 유형입니다.
WorkflowTextFormatTextFormatElement에 정의된 스타일, 하이퍼링크, 대화형 요소를 비롯한 서식 옵션이 풍부한 텍스트 블록입니다.
WorkflowValidationErrorAction이 작업은 호스트 앱 (Google Workspace Studio)이 유효성 검사 오류를 표시해야 함을 나타냅니다.

Action

메서드

메서드반환 유형간략한 설명
addModifyCard(modifyCard)Action작업에 ModifyCard 작업을 추가합니다.
addNavigation(navigation)Action작업에 카드 탐색을 추가합니다.

AddOnsResponseService

메서드

메서드반환 유형간략한 설명
newAction()ActionAction를 만듭니다.
newNavigation()NavigationNavigation를 만듭니다.
newRenderActionBuilder()RenderActionBuilderRenderActionBuilder를 만듭니다.

BasicDataType

속성

속성유형설명
BASIC_TYPE_UNSPECIFIEDEnum기본값
STRINGEnum문자열입니다.
INTEGEREnum정수 값입니다.
FLOATEnum부동 소수점 숫자입니다.
TIMESTAMPEnumISO 8601 형식의 타임스탬프입니다.
BOOLEANEnum부울 값
EMAIL_ADDRESSEnum이메일 주소 형식의 문자열입니다.
GOOGLE_USEREnumGoogle 서비스 사용자입니다. 형식은 'users/encoded_GAIA_ID'입니다.
FILEEnum파일 형식입니다.
FORMATTED_TEXTEnum서식이 풍부한 텍스트입니다.

Color

메서드

메서드반환 유형간략한 설명
setAlpha(alpha)Color색상의 알파 구성요소를 설정합니다.
setBlue(blue)Color색상의 파란색 구성요소를 설정합니다.
setGreen(green)Color색상의 녹색 구성요소를 설정합니다.
setRed(red)Color색상의 빨간색 구성요소를 설정합니다.

DataType

메서드

메서드반환 유형간략한 설명
setBasicDataType(basicDataType)DataType데이터 유형을 지원되는 BasicDataType 중 하나로 설정합니다.
setResourceType(resourceType)DataType데이터 유형을 맞춤 정의된 ResourceType로 설정합니다.
setValueMetadata(valueMetadata)DataType변수와 관련된 유형 관련 정보가 포함된 ValueMetadata를 설정합니다.

DynamicResourceDefinition

메서드

메서드반환 유형간략한 설명
addResourceField(resourceField)DynamicResourceDefinition동적 리소스 정의에 리소스 필드를 추가합니다.
setResourceId(resourceId)DynamicResourceDefinition동적 리소스 정의의 ID를 설정합니다. 이 ID는 매니페스트의 workflowResourceDefinitionId에 해당합니다.

ErrorActionability

속성

속성유형설명
ERROR_ACTIONABILITY_UNSPECIFIEDEnum지정되지 않음.
NOT_ACTIONABLEEnum사용자가 구성 카드를 통해 오류를 수정할 수 없습니다.
ACTIONABLEEnum사용자가 구성 카드를 통해 오류를 수정할 수 있습니다.

ErrorRetryability

속성

속성유형설명
RETRYABILITY_UNSPECIFIEDEnum지정되지 않음.
NOT_RETRYABLEEnum오류를 다시 시도할 수 없으며 첫 번째 시도 후 흐름이 종료됩니다.
RETRYABLEEnum오류를 다시 시도할 수 있습니다. 워크플로는 최대 5회까지 단계를 실행하려고 시도합니다.

FontWeight

속성

속성유형설명
FONT_WEIGHT_UNSPECIFIEDEnum일반 두께의 표준 가중치입니다.
LIGHTEnum두께가 줄어 더 가벼워졌습니다.
MEDIUMEnum일반과 볼드 사이의 중간 두께입니다.
BOLDEnum두께가 증가한 더 무거운 무게

HostAppAction

메서드

메서드반환 유형간략한 설명
setWorkflowAction(workflowAction)HostAppAction호스트 앱 작업을 워크플로 작업으로 설정합니다.

메서드

메서드반환 유형간략한 설명
setLink(link)Hyperlink하이퍼링크의 대상 URL을 설정합니다.
setText(text)Hyperlink하이퍼링크의 텍스트를 설정합니다.

InsertSection

메서드

메서드반환 유형간략한 설명
insertAtTop(onCardTop)InsertSection새 섹션을 카드 상단에 삽입해야 하는지 여부를 나타내는 onCardTop 플래그를 설정합니다.
insertBelowSection(sectionId)InsertSection섹션 ID를 설정하며 새 섹션이 아래에 삽입됩니다.
setSection(section)InsertSection삽입할 카드 섹션을 설정합니다.

InsertWidget

메서드

메서드반환 유형간략한 설명
insertAboveWidget(widgetId)InsertWidget위젯 ID를 설정하며 새 위젯이 지정된 ID의 위젯 위에 삽입됩니다.
insertBelowWidget(widgetId)InsertWidget위젯 ID를 설정하며 새 위젯이 지정된 ID의 위젯 아래에 삽입됩니다.
setWidget(widget)InsertWidget삽입할 Widget를 설정합니다.

메서드

메서드반환 유형간략한 설명
setTitle(title)Link링크의 제목을 설정합니다.
setUrl(url)Link링크의 URL을 설정합니다.

ListContainer

메서드

메서드반환 유형간략한 설명
addListItem(listItem)ListContainer목록 컨테이너에 목록 항목을 추가합니다.
setListNestLevel(listLevel)ListContainer목록의 수준을 설정합니다. 최상위 수준은 0에서 시작하고 중첩된 목록마다 1씩 증가합니다.
setListType(listType)ListContainer목록의 유형을 순서가 지정된 목록 또는 순서가 지정되지 않은 목록으로 설정합니다.

ListItem

메서드

메서드반환 유형간략한 설명
addTextFormatElement(textFormatElement)ListItem목록 항목에 TextFormatElement을 추가합니다.

ListType

속성

속성유형설명
LIST_TYPE_UNSPECIFIEDEnum기본값
ORDEREDEnum순서가 지정된 목록입니다.
UNORDEREDEnum순서가 지정되지 않은 목록

ModifyCard

메서드

메서드반환 유형간략한 설명
setInsertSection(insertSection)ModifyCard이 수정 카드 객체의 InsertSection를 설정합니다.
setInsertWidget(insertWidget)ModifyCard이 수정 카드 객체의 InsertWidget를 설정합니다.
setRemoveSection(removeSection)ModifyCard이 수정 카드 객체의 RemoveSection를 설정합니다.
setRemoveWidget(removeWidget)ModifyCard이 수정 카드 객체의 RemoveWidget를 설정합니다.
setReplaceSection(replacementSection)ModifyCard이 카드 수정 객체의 대체 CardSection를 설정합니다. 대체 섹션의 ID는 기존 카드 섹션과 동일해야 합니다.
setReplaceWidget(replacementWidget)ModifyCard이 카드 수정 객체의 대체 위젯을 설정합니다. 대체 위젯은 기존 위젯과 ID가 동일해야 합니다.
setUpdateWidget(updateWidget)ModifyCard이 수정 카드 객체의 UpdateWidget를 설정합니다.

메서드

메서드반환 유형간략한 설명
printJson()String이 객체의 JSON 표현을 출력합니다.
pushCard(card)Navigation지정된 카드를 스택에 푸시합니다.

RemoveSection

메서드

메서드반환 유형간략한 설명
setSectionId(sectionId)RemoveSection삭제할 섹션의 섹션 ID를 설정합니다.

RemoveWidget

메서드

메서드반환 유형간략한 설명
setWidgetId(widgetId)RemoveWidget삭제할 위젯의 위젯 ID를 설정합니다.

RenderAction

메서드

메서드반환 유형간략한 설명
printJson()String이 객체의 JSON 표현을 출력합니다.

RenderActionBuilder

메서드

메서드반환 유형간략한 설명
build()RenderAction현재 렌더링 작업을 빌드하고 유효성을 검사합니다.
setAction(action)RenderActionBuilder부가기능이 UI를 업데이트하는 데 사용할 수 있는 작업을 렌더링 작업으로 설정합니다.
setHostAppAction(hostAppAction)RenderActionBuilder개별 호스트 앱에서 처리하는 HostAppAction을 렌더링 작업으로 설정합니다.

ResourceData

메서드

메서드반환 유형간략한 설명
addVariableData(key, value)ResourceData변수 이름으로 키가 지정된 VariableData를 추가합니다. 키가 이미 있으면 값이 덮어쓰여집니다.
setVariableDataMap(fields)ResourceData변수 이름으로 키가 지정된 변수 데이터의 맵을 설정합니다.

ResourceField

메서드

메서드반환 유형간략한 설명
setDataType(dataType)ResourceField필드의 데이터 유형을 설정하여 다른 단계에서 선택 시 유형별로 변수를 필터링할 수 있도록 합니다.
setDisplayText(displayText)ResourceField후속 단계에서 변수 선택 중에 최종 사용자에게 표시되는 필드의 설명을 설정합니다.
setSelector(selector)ResourceField단계 실행 중에 값을 제공할 제공자 함수의 키를 설정합니다.

ResourceFieldsDefinitionRetrievedAction

메서드

메서드반환 유형간략한 설명
addDynamicResourceDefinition(dynamicResourceDefinition)ResourceFieldsDefinitionRetrievedAction검색된 리소스 필드 정의 작업에 DynamicResourceDefinition를 추가합니다.

ResourceRetrievedAction

메서드

메서드반환 유형간략한 설명
setResourceData(resourceData)ResourceRetrievedAction동적 리소스 필드 또는 맞춤 리소스 필드에 값을 제공하기 위해 리소스 가져오기 작업에 ResourceData을 설정합니다.

ResourceType

메서드

메서드반환 유형간략한 설명
setWorkflowResourceDefinitionId(resourceType)ResourceType워크플로 리소스 정의 ID를 설정합니다.

ReturnElementErrorAction

메서드

메서드반환 유형간략한 설명
setErrorActionability(errorActionability)ReturnElementErrorAction오류 조치 가능성을 설정합니다. 단계를 재구성하여 해결할 수 있는 경우 오류는 조치 가능해야 합니다.
setErrorLog(log)ReturnElementErrorAction워크플로의 활동 피드에 최종 사용자에게 표시할 오류 로그를 설정합니다.
setErrorRetryability(errorRetryability)ReturnElementErrorAction오류 재시도 가능성을 설정합니다. 오류를 재시도할 수 없는 경우 첫 번째 시도 후 흐름이 종료됩니다.

ReturnOutputVariablesAction

메서드

메서드반환 유형간략한 설명
addVariableData(key, value)ReturnOutputVariablesAction변수 이름으로 키가 지정된 변수 데이터를 추가합니다. 키가 이미 있으면 값이 덮어쓰여집니다.
setLog(log)ReturnOutputVariablesAction실행된 워크플로 작업의 로그를 워크플로의 활동 피드에서 최종 사용자에게 설정합니다.
setVariableDataMap(variables)ReturnOutputVariablesAction변수 이름으로 키가 지정된 변수 데이터의 맵을 설정합니다. 키가 이미 있는 경우 값이 덮어쓰여집니다.

SaveWorkflowAction

StyledText

메서드

메서드반환 유형간략한 설명
addStyle(style)StyledText스타일이 지정된 텍스트의 스타일을 설정합니다. 단일 스타일이 지정된 텍스트에 여러 스타일을 적용할 수 있습니다.
setColor(color)StyledText스타일이 지정된 텍스트의 색상을 설정합니다.
setFontWeight(fontWeight)StyledText스타일이 지정된 텍스트의 글꼴 두께를 설정합니다.
setText(text)StyledText스타일이 지정된 텍스트의 기본 콘텐츠를 설정합니다.

TextFormatChip

메서드

메서드반환 유형간략한 설명
setLabel(label)TextFormatChip칩에 표시되는 텍스트를 설정합니다.
setTextFormatIcon(icon)TextFormatChip칩에 표시되는 아이콘을 설정합니다.
setUrl(url)TextFormatChip칩을 클릭했을 때 이동할 URL을 설정합니다.

TextFormatElement

메서드

메서드반환 유형간략한 설명
setHyperlink(hyperlink)TextFormatElement텍스트 형식 요소를 Hyperlink로 설정합니다.
setListContainer(listContainer)TextFormatElement텍스트 형식 요소를 ListContainer로 설정합니다.
setStyledText(styledText)TextFormatElement텍스트 형식 요소를 StyledText로 설정합니다.
setText(text)TextFormatElement텍스트 형식 요소를 텍스트 문자열로 설정합니다.
setTextFormatChip(chip)TextFormatElement텍스트 형식 요소를 TextFormatChip로 설정합니다.

TextFormatIcon

메서드

메서드반환 유형간략한 설명
setIconUrl(iconUrl)TextFormatIcon아이콘 URL을 설정합니다.
setMaterialIconName(materialIconName)TextFormatIconGoogle Material Icons에 정의된 머티리얼 아이콘 이름을 설정합니다.

TextStyle

속성

속성유형설명
STYLE_UNSPECIFIEDEnum스타일이 적용되지 않았습니다.
ITALICEnum기울임꼴 스타일입니다.
UNDERLINEEnum밑줄 스타일입니다.
STRIKETHROUGHEnum취소선 스타일입니다.
LINE_BREAKEnum줄바꿈입니다.
UPPERCASEEnum대문자 스타일입니다.
CODEEnum코드 스타일
CODE_BLOCKEnum코드 블록 스타일입니다.

TimeStamp

메서드

메서드반환 유형간략한 설명
setNanos(nanos)TimeStamp타임스탬프의 나노를 설정합니다. 현재 초 내의 나노초 수를 나타냅니다.
setSeconds(seconds)TimeStamp타임스탬프의 초를 설정합니다. 이는 Unix epoch(1970년 1월 1일 00:00:00 UTC) 이후의 초 수를 나타냅니다.

UpdateWidget

메서드

메서드반환 유형간략한 설명
addSuggestion(text, value, selected, startIconUri, bottomText)UpdateWidget다중 선택 메뉴에서 선택할 수 있는 새 항목을 추가합니다.

ValidationErrorSeverity

속성

속성유형설명
SEVERITY_UNSPECIFIEDEnum지정되지 않음.
CRITICALEnum심각: 오류가 심각하며 게시 전에 수정해야 합니다.
WARNINGEnum경고, 오류가 중요하지 않으며 게시를 차단하지 않습니다.

ValueMetadata

메서드

메서드반환 유형간략한 설명
addCastableType(dataType)ValueMetadata변수 데이터에 동적으로 캐스팅될 수 있는 선택적 허용 유형을 이 값 메타데이터에 추가합니다.
addEnumValue(enumValue)ValueMetadata변수의 허용된 enum 값에 선택적 문자열 값을 추가합니다. 이 필드는 DataType이 문자열 유형으로 설정된 경우에만 설정할 수 있습니다.
setDefaultValue(defaultValue)ValueMetadata변수의 선택적 기본값을 설정합니다. 예를 들어 변수 유형이 불리언인 경우 defaultValue를 'true' 또는 'false'로 설정할 수 있습니다.

VariableData

메서드

메서드반환 유형간략한 설명
addBooleanValue(value)VariableData변수 데이터에 불리언 값을 추가합니다.
addEmailAddress(emailAddress)VariableData변수 데이터에 이메일 주소를 추가합니다.
addFloatValue(value)VariableData변수 데이터에 float 값을 추가합니다.
addGoogleUser(googleUser)VariableData변수 데이터에 Google 사용자를 추가합니다.
addIntegerValue(value)VariableData변수 데이터에 정수 값을 추가합니다.
addResourceData(resourceData)VariableData변수 데이터에 ResourceData 값을 추가합니다.
addResourceReference(resourceReference)VariableData변수 데이터에 리소스 참조 ID를 추가합니다.
addStringValue(value)VariableData변수 데이터에 문자열 값을 추가합니다.
addTimestampValue(value)VariableData변수 데이터에 TimeStamp 값을 추가합니다.
addWorkflowTextFormat(workflowTextFormat)VariableData변수 데이터에 WorkflowTextFormat 값을 추가합니다.

WorkflowAction

WorkflowTextFormat

메서드

메서드반환 유형간략한 설명
addTextFormatElement(textFormatElement)WorkflowTextFormat워크플로 텍스트 형식에 TextFormatElement를 추가합니다.

WorkflowValidationErrorAction

메서드

메서드반환 유형간략한 설명
setSeverity(severity)WorkflowValidationErrorAction유효성 검사 오류의 심각도를 설정합니다.