OnClick

表示当用户点击卡片上的互动元素(例如按钮)时如何响应。

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{

  "action": {
    object (Action)
  },
  "openLink": {
    object (OpenLink)
  },
  "openDynamicLinkAction": {
    object (Action)
  },
  "card": {
    object (Card)
  },
  "overflowMenu": {
    object (OverflowMenu)
  }
}
字段
以下是互斥字段的列表。在响应中,最多只能设置以下字段之一:
action

object (Action)

如果指定,则此 onClick 会触发操作。

card

object (Card)

点击后,系统会将一张新卡片推送到卡片堆栈(如果已指定)。

适用于 Google Workspace 插件,不适用于 Google Chat 应用。

overflowMenu

object (OverflowMenu)

如果指定,此 onClick 会打开一个菜单。

互斥字段结束。

OpenAs

当 OnClick 操作打开链接时,客户端可以将其作为全尺寸窗口(如果这是客户端使用的框架)或叠加层(例如弹出式窗口)打开。具体实现取决于客户端平台功能,如果客户端不支持所选值,则系统可能会忽略该值。所有客户端都支持 FULL_SIZE。

适用于 Google Workspace 插件,不适用于 Google Chat 应用。

枚举
FULL_SIZE 链接会以全尺寸窗口的形式打开(如果这是客户端使用的框架)。
OVERLAY 链接会以叠加层(例如弹出式窗口)的形式打开。

OnClose

当 OnClick 操作打开的链接关闭时,客户端执行的操作。

具体实现取决于客户端平台功能。例如,网络浏览器可能会使用 OnClose 处理程序在弹出式窗口中打开链接。

如果同时设置了 OnOpen 和 OnClose 处理程序,并且客户端平台无法同时支持这两个值,则以 OnClose 为准。

适用于 Google Workspace 插件,不适用于 Google Chat 应用。

枚举
NOTHING 默认值。卡片不会重新加载,没有任何变化。
RELOAD

在子窗口关闭后重新加载卡片。

如果与 OpenAs.OVERLAY 结合使用,子窗口会充当模态对话框,并且父级卡片会被屏蔽,直到子窗口关闭。

OverflowMenu

一个微件,用于显示包含一个或多个可供用户调用的操作的弹出式菜单。例如,在卡片中显示非主要操作。当可用空间不足以容纳操作时,您可以使用此 widget。如需使用此微件,请在支持此微件的微件的 OnClick 操作中指定此微件。例如,在 Button 中。

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "items": [
    {
      object (OverflowMenuItem)
    }
  ]
}
字段
items[]

object (OverflowMenuItem)

必需。菜单选项列表。

OverflowMenuItem

用户可以在溢出菜单中调用的选项。

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "startIcon": {
    object (Icon)
  },
  "text": string,
  "onClick": {
    object (OnClick)
  },
  "disabled": boolean
}
字段
startIcon

object (Icon)

文本前面显示的图标。

text

string

必需。向用户标识或描述商品的文字。

onClick

object (OnClick)

必需。选择菜单选项时调用的操作。此 OnClick 不能包含 OverflowMenu,任何指定的 OverflowMenu 都会被丢弃,并且菜单项会被停用。

disabled

boolean

菜单选项是否已停用。默认值为 false。