代表使用者點選資訊卡上的互動元素 (例如按鈕) 時,系統應如何回應。
適用於 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
這個小工具會顯示彈出式選單,其中包含一或多個使用者可叫用的動作。例如在資訊卡中顯示非主要動作。如果可用空間不足以容納動作,您可以使用這個小工具。如要使用,請在支援的小工具 OnClick 動作中指定這個小工具。例如,在 Button 中。
適用於 Google Chat 擴充應用程式和 Google Workspace 外掛程式。
| JSON 表示法 |
|---|
{
"items": [
{
object ( |
| 欄位 | |
|---|---|
items[] |
必填。選單選項清單。 |
OverflowMenuItem
使用者可在溢位選單中叫用的選項。
適用於 Google Chat 擴充應用程式和 Google Workspace 外掛程式。
| JSON 表示法 |
|---|
{ "startIcon": { object ( |
| 欄位 | |
|---|---|
startIcon |
顯示在文字前方的圖示。 |
text |
必填。向使用者識別或描述項目的文字。 |
onClick |
必填。選取選單選項時叫用的動作。這個 |
disabled |
是否停用選單選項。預設值為 false。 |