AddOns Response Service

添加插件响应服务

此服务允许脚本配置和构建可扩展 Google Workspace Studio 的 Google Workspace 插件。

名称简介
ActionGoogle Workspace 插件(用于扩展 Google Workspace Studio)可使用此操作来呈现新卡片。
AddOnsResponseServiceAddOnsResponseService 能够为扩展 Google Workspace Studio 的 Google Workspace 插件创建响应。
BasicDataType表示基本泛型数据类型的枚举。
Color一个 Color 对象,表示 RGBA 颜色空间中的一种颜色。
DataTypeDataType 用于设置变量的类型。
DynamicResourceDefinitionDynamicResourceDefinition 是 ResourceFieldsDefinitionRetrievedAction 的构建块,它可以包含一个或多个 ResourceField,以动态定义 Google Workspace Studio 中某个步骤提供的输出变量数量。
ErrorActionability表示错误可操作性的枚举。
ErrorRetryability一个枚举,用于表示在出现错误时操作调用的可重试性。
FontWeight表示带样式的文本的字重的枚举。
HostAppActionHostAppAction 是一种由各个宿主应用处理的 Action。
HyperlinkTextFormatElement 中使用的超链接元素。
InsertSection用于构建 InsertSection 对象的构建器。
InsertWidget用于构建 InsertWidget 对象的构建器。
Link来自第三方资源的链接对象,该对象在宿主应用中转换为智能条状标签。
ListContainer列表项的容器,其中每个列表项可以包含多个 TextFormatElement
ListItem一个列表项,其中每个列表项可以包含多个 TextFormatElement
ListType表示列表类型的枚举。
ModifyCard用于构建 ModifyCard 对象的构建器,该对象通过将 ModifyCard 对象传递给 Action 来更改和更新现有卡的界面。
Navigation用于控制卡片导航的辅助对象。
RemoveSectionRemoveSection 对象的构建器。
RemoveWidgetRemoveWidget 对象的构建器。
RenderAction通过执行 Action 来响应用户互动,从而渲染或更新卡片。
RenderActionBuilderRenderAction 对象的构建器。
ResourceData表示应用特定的资源数据,资源数据包含变量名称和 VariableData 的键值对集合。
ResourceFieldResourceField 是 DynamicResourceDefinition 的基本构建块,每个资源字段都对应于当前步骤的输出变量。
ResourceFieldsDefinitionRetrievedActionResourceFieldsDefinitionRetrievedAction 是一种 ResourceFieldsDefinitionRetrievedAction,用于通过清单中指定的 dynamicResourceDefinitionProvider 函数检索资源字段列表的定义。
ResourceRetrievedActionResourceRetrievedAction 用于在需要时检索自定义资源内容,其中自定义资源字段在 ResourceData 中定义。
ResourceType一种特定于应用的资源类型,该资源类型的唯一标识符应具有相应的 WorkflowResourceDefinition。
ReturnElementErrorActionReturnElementErrorAction 表示在元素调用期间发生了错误。
ReturnOutputVariablesAction包含 Google Workspace Studio 中执行的操作生成的输出变量。
SaveWorkflowAction此操作表示宿主应用 (Google Workspace Studio) 应保存代理。
StyledText具有粗体、斜体和颜色等样式的文本元素。
TextFormatChip文本格式的可点击 chip。
TextFormatElement文本格式元素,可以是 TextFormatChipStyledTextHyperlinkListContainer
TextFormatIcon显示在 TextFormatChip 中的图标。
TextStyle表示带样式的文本的样式的枚举。
TimeStamp表示可添加到 VariableData 的时间戳对象。
UpdateWidgetUpdateWidget 对象的构建器。
ValidationErrorSeverity表示验证错误严重程度的枚举。
ValueMetadatavalueMetadata 包含有关变量潜在值的信息。
VariableData表示一种可变数据,可以包含各种类型的值集合。
WorkflowActionWorkflowAction 是一种 HostAppAction,用于在 Google Workspace Studio 中执行特定操作。
WorkflowTextFormat一个文本块,包含在 TextFormatElement 中定义的富格式设置选项,包括样式、超链接和互动元素。
WorkflowValidationErrorAction此操作表示宿主应用 (Google Workspace Studio) 应显示验证错误。

Action

方法

方法返回类型简介
addModifyCard(modifyCard)Action向操作添加 ModifyCard 操作。
addNavigation(navigation)Action向操作添加卡片导航。

AddOnsResponseService

方法

方法返回类型简介
newAction()Action创建新的 Action
newNavigation()Navigation创建新的 Navigation
newRenderActionBuilder()RenderActionBuilder创建新的 RenderActionBuilder

BasicDataType

属性

属性类型说明
BASIC_TYPE_UNSPECIFIEDEnum默认值。
STRINGEnum一个字符串。
INTEGEREnum一个整数值。
FLOATEnum浮点数。
TIMESTAMPEnum采用 ISO 8601 格式的时间戳。
BOOLEANEnum布尔值。
EMAIL_ADDRESSEnum格式为电子邮件地址的字符串。
GOOGLE_USEREnumGoogle 服务用户,格式为“users/encoded_GAIA_ID”
FILEEnum文件类型。
FORMATTED_TEXTEnum具有丰富格式的文本。

Color

方法

方法返回类型简介
setAlpha(alpha)Color设置颜色的 Alpha 分量。
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设置超链接的目标网址。
setText(text)Hyperlink设置超链接的文本。

InsertSection

方法

方法返回类型简介
insertAtTop(onCardTop)InsertSection设置 onCardTop 标志,用于指示是否应将新部分插入到卡片的顶部。
insertBelowSection(sectionId)InsertSection设置版块 ID,新版块将插入到该 ID 下方。
setSection(section)InsertSection设置要插入的卡片部分。

InsertWidget

方法

方法返回类型简介
insertAboveWidget(widgetId)InsertWidget设置 widget ID,并将新 widget 插入到具有指定 ID 的 widget 上方。
insertBelowWidget(widgetId)InsertWidget设置 widget ID,并将新 widget 插入到具有指定 ID 的 widget 下方。
setWidget(widget)InsertWidget设置要插入的 Widget

方法

方法返回类型简介
setTitle(title)Link设置链接的标题。
setUrl(url)Link设置链接的网址。

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设置要移除的 widget 的 widget ID。

RenderAction

方法

方法返回类型简介
printJson()String输出此对象的 JSON 表示形式。

RenderActionBuilder

方法

方法返回类型简介
build()RenderAction构建当前渲染操作并对其进行验证。
setAction(action)RenderActionBuilder将插件可用于更新界面的操作设置为渲染操作。
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)ResourceRetrievedActionResourceData 设置为检索到的资源操作,以向动态资源字段或自定义资源字段提供值。

ResourceType

方法

方法返回类型简介
setWorkflowResourceDefinitionId(resourceType)ResourceType设置工作流资源定义 ID。

ReturnElementErrorAction

方法

方法返回类型简介
setErrorActionability(errorActionability)ReturnElementErrorAction设置错误的可操作性,如果可以通过重新配置步骤来解决错误,则该错误应该是可操作的。
setErrorLog(log)ReturnElementErrorAction设置要在工作流的活动 Feed 中向最终用户显示错误日志。
setErrorRetryability(errorRetryability)ReturnElementErrorAction设置错误重试能力,如果错误不可重试,则流程在第一次尝试后终止。

ReturnOutputVariablesAction

方法

方法返回类型简介
addVariableData(key, value)ReturnOutputVariablesAction添加以变量名称为键的变量数据,如果键已存在,则覆盖相应的值。
setLog(log)ReturnOutputVariablesAction将已执行的工作流操作的日志设置到工作流的活动 Feed 中,供最终用户查看。
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设置点击条状标签后要前往的网址。

TextFormatElement

方法

方法返回类型简介
setHyperlink(hyperlink)TextFormatElement将文本格式元素设置为 Hyperlink
setListContainer(listContainer)TextFormatElement将文本格式元素设置为 ListContainer
setStyledText(styledText)TextFormatElement将文本格式元素设置为 StyledText
setText(text)TextFormatElement将文本格式元素设置为文本字符串。
setTextFormatChip(chip)TextFormatElement将文本格式元素设置为 TextFormatChip

TextFormatIcon

方法

方法返回类型简介
setIconUrl(iconUrl)TextFormatIcon设置图标网址。
setMaterialIconName(materialIconName)TextFormatIcon设置 Google Material 图标中定义的 Material 图标名称。

TextStyle

属性

属性类型说明
STYLE_UNSPECIFIEDEnum未应用任何样式。
ITALICEnum斜体样式。
UNDERLINEEnum下划线样式。
STRIKETHROUGHEnum删除线样式。
LINE_BREAKEnum换行符。
UPPERCASEEnum大写样式。
CODEEnum代码样式。
CODE_BLOCKEnum代码块样式。

TimeStamp

方法

方法返回类型简介
setNanos(nanos)TimeStamp设置时间戳的纳秒部分,表示当前秒内的纳秒数。
setSeconds(seconds)TimeStamp设置时间戳的秒数,表示自 Unix 纪元(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向变量的允许枚举值添加一个可选的字符串值,只有在 DataType 设置为 String 类型时,才能设置此字段。
setDefaultValue(defaultValue)ValueMetadata设置变量的可选默认值,例如,如果变量类型为布尔值,则 defaultValue 可设置为“true”或“false”。

VariableData

方法

方法返回类型简介
addBooleanValue(value)VariableData向变量数据添加布尔值。
addEmailAddress(emailAddress)VariableData向变量数据添加电子邮件地址。
addFloatValue(value)VariableData向变量数据添加浮点值。
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设置验证错误的严重程度。