表示当用户点击卡片上的互动元素(例如按钮)时如何响应。
适用于 Google Chat 应用和 Google Workspace 插件。
| JSON 表示法 |
|---|
{ "action": { object ( |
| 字段 | |
|---|---|
| 以下是互斥字段的列表。在响应中,最多只能设置以下字段之一: | |
action |
如果指定,则此 |
openLink |
如果指定,此 |
openDynamicLinkAction |
当操作需要打开链接时,插件会触发此操作。这与上述
|
card |
点击后,系统会将一张新卡片推送到卡片堆栈(如果已指定)。
|
overflowMenu |
如果指定,此 |
| 互斥字段结束。 | |
OpenLink
表示打开超链接的 onClick 事件。
适用于 Google Chat 应用和 Google Workspace 插件。
| JSON 表示法 |
|---|
{ "url": string, "openAs": enum ( |
| 字段 | |
|---|---|
url |
要打开的网址。HTTP 网址会转换为 HTTPS。 |
openAs |
如何打开链接。
|
onClose |
客户端是在打开链接后忘记该链接,还是在窗口关闭之前一直观察该链接。
|
OpenAs
当 OnClick 操作打开链接时,客户端可以将其作为全尺寸窗口(如果这是客户端使用的框架)或叠加层(例如弹出式窗口)打开。具体实现取决于客户端平台功能,如果客户端不支持所选值,则系统可能会忽略该值。所有客户端都支持 FULL_SIZE。
适用于 Google Workspace 插件,不适用于 Google Chat 应用。
| 枚举 | |
|---|---|
FULL_SIZE |
链接会以全尺寸窗口的形式打开(如果这是客户端使用的框架)。 |
OVERLAY |
链接会以叠加层(例如弹出式窗口)的形式打开。 |
OnClose
当 OnClick 操作打开的链接关闭时,客户端执行的操作。
具体实现取决于客户端平台功能。例如,网络浏览器可能会使用 OnClose 处理程序在弹出式窗口中打开链接。
如果同时设置了 OnOpen 和 OnClose 处理程序,并且客户端平台无法同时支持这两个值,则以 OnClose 为准。
适用于 Google Workspace 插件,不适用于 Google Chat 应用。
| 枚举 | |
|---|---|
NOTHING |
默认值。卡片不会重新加载,没有任何变化。 |
RELOAD |
在子窗口关闭后重新加载卡片。 如果与 |
OverflowMenu
一个微件,用于显示包含一个或多个可供用户调用的操作的弹出式菜单。例如,在卡片中显示非主要操作。当可用空间不足以容纳操作时,您可以使用此 widget。如需使用此微件,请在支持此微件的微件的 OnClick 操作中指定此微件。例如,在 Button 中。
适用于 Google Chat 应用和 Google Workspace 插件。
| JSON 表示法 |
|---|
{
"items": [
{
object ( |
| 字段 | |
|---|---|
items[] |
必需。菜单选项列表。 |
OverflowMenuItem
用户可以在溢出菜单中调用的选项。
适用于 Google Chat 应用和 Google Workspace 插件。
| JSON 表示法 |
|---|
{ "startIcon": { object ( |
| 字段 | |
|---|---|
startIcon |
文本前面显示的图标。 |
text |
必需。向用户标识或描述商品的文字。 |
onClick |
必需。选择菜单选项时调用的操作。此 |
disabled |
菜单选项是否已停用。默认值为 false。 |