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

這個小工具會顯示彈出式選單,其中包含一或多個使用者可叫用的動作。例如在資訊卡中顯示非主要動作。如果可用空間不足以容納動作,您可以使用這個小工具。如要使用,請在支援的小工具 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。