資訊卡
資訊卡是一種 UI 元素,可包含文字和圖片等 UI 小工具。
JSON 表示法 |
---|
{ "header": { object ( |
欄位 | |
---|---|
header
|
資訊卡的標題。標題通常包含標題和圖片。 |
sections[]
|
以線分隔線分隔區段。 |
cardActions[]
|
這張資訊卡的動作。 |
name
|
卡片名稱。 |
CardHeader
JSON 表示法 |
---|
{
"title": string,
"subtitle": string,
"imageStyle": enum (
|
欄位 | |
---|---|
title
|
必須指定標題。標頭的高度固定:如果同時指定標題和副標題,則標題和副標題都會佔一行。如果僅指定標題,則會同時採用兩行。 |
subtitle
|
資訊卡標頭的副標題。 |
imageStyle
|
圖片的類型 (例如方形框線或圓形框線)。 |
imageUrl
|
資訊卡標頭中的圖片網址。 |
ImageStyle
列舉 | |
---|---|
IMAGE_STYLE_UNSPECIFIED
|
|
IMAGE
|
正方形框線。 |
AVATAR
|
圓形框線。 |
區段
區段包含一組小工具,會按指定順序顯示 (垂直)。在所有平台中,資訊卡的固定寬度較窄,因此目前不需要版面配置屬性 (例如浮點值)。
JSON 表示法 |
---|
{
"header": string,
"widgets": [
{
object (
|
欄位 | |
---|---|
header
|
章節的標題。系統支援格式化文字。如要進一步瞭解如何設定文字格式,請參閱「在 Google Chat 應用程式中設定文字格式」和「在 Google Workspace 外掛程式中設定文字格式」。 |
widgets[]
|
一個區段必須至少包含一個小工具。 |
WidgetMarkup
小工具是一種呈現文字和圖片的 UI 元素。
JSON 表示法 |
---|
{ "buttons": [ { object ( |
欄位 | |
---|---|
buttons[]
|
按鈕清單。按鈕也是 |
聯集欄位 data 。WidgetMarkup 只能包含下列其中一個項目。您可以使用多個 WidgetMarkup 欄位顯示更多項目。data 只能採用下列其中一種設定: |
|
textParagraph
|
在這個小工具中顯示文字段落。 |
image
|
顯示這個小工具中的圖片。 |
keyValue
|
在這個小工具中顯示鍵/值項目。 |
TextParagraph
一段文字。支援格式化文字。如要進一步瞭解如何設定文字格式,請參閱「在 Google Chat 應用程式中設定文字格式」和「在 Google Workspace 外掛程式中設定文字格式」。
JSON 表示法 |
---|
{ "text": string } |
欄位 | |
---|---|
text
|
|
圖片
使用網址指定的圖片,可以具有 onclick
動作。
JSON 表示法 |
---|
{
"imageUrl": string,
"onClick": {
object (
|
欄位 | |
---|---|
imageUrl
|
圖片的網址。 |
onClick
|
|
aspectRatio
|
這張圖片的顯示比例 (寬度和高度)。這個欄位可讓您在等待載入的同時,保留圖片的正確高度。也不代表圖片的內建顯示比例。如未設定,伺服器會預先擷取圖片來填入內容。 |
OnClick
onclick
動作 (例如開啟連結)。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位
|
|
action
|
這項 |
openLink
|
這個 |
FormAction
表單動作可說明提交表單時的行為。舉例來說,您可以叫用 Apps Script 來處理表單。
JSON 表示法 |
---|
{
"actionMethodName": string,
"parameters": [
{
object (
|
欄位 | |
---|---|
actionMethodName
|
方法名稱可用來識別表單的哪個部分觸發了提交表單。這些資訊會做為資訊卡點擊事件的一部分傳回 Chat 應用程式。您可以為觸發常見行為的多個元素使用相同的方法名稱, |
parameters[]
|
動作參數清單。 |
ActionParameter
叫用動作方法時,要使用的字串參數清單。舉例來說,請考慮設定三個延後按鈕:立即延後、延後一天、下週再貪睡。您可以使用 action method = snooze()
,在字串參數清單中傳遞延後類型和延後時間。
JSON 表示法 |
---|
{ "key": string, "value": string } |
欄位 | |
---|---|
key
|
動作指令碼的參數名稱。 |
value
|
參數值。 |
OpenLink
開啟新視窗的連結。
JSON 表示法 |
---|
{ "url": string } |
欄位 | |
---|---|
url
|
要開啟的網址。 |
KeyValue
UI 元素包含鍵 (標籤) 和值 (內容)。這個元素也可以包含部分動作,例如 onclick
按鈕。
JSON 表示法 |
---|
{ "topLabel": string, "content": string, "contentMultiline": boolean, "bottomLabel": string, "onClick": { object ( |
欄位 | |
---|---|
topLabel
|
最上層標籤的文字。支援格式化文字。如要進一步瞭解如何設定文字格式,請參閱「在 Google Chat 應用程式中設定文字格式」和「在 Google Workspace 外掛程式中設定文字格式」。 |
content
|
內容的文字。支援格式化文字,且一律為必要。如要進一步瞭解如何設定文字格式,請參閱「在 Google Chat 應用程式中設定文字格式」和「在 Google Workspace 外掛程式中設定文字格式」。 |
contentMultiline
|
內容是否為多行。 |
bottomLabel
|
底部標籤的文字。支援格式化文字。如要進一步瞭解如何設定文字格式,請參閱「在 Google Chat 應用程式中設定文字格式」和「在 Google Workspace 外掛程式中設定文字格式」。 |
onClick
|
|
聯集欄位 icons 。必須定義至少一個圖示、top_label 和 bottom_label 。icons 只能採用下列其中一種設定: |
|
icon
|
由 Chat API 替換為對應圖示圖片的列舉值。 |
iconUrl
|
網址指定的圖示。 |
聯集欄位 control 。控制項小工具。您可以設定 button 或 switch_widget ,但不能同時設定兩者。control 只能採用下列其中一種設定: |
|
button
|
使用者點選按鈕即可觸發動作。 |
圖示
支援的圖示組合。
列舉 | |
---|---|
ICON_UNSPECIFIED
|
|
AIRPLANE
|
|
BOOKMARK
|
|
BUS
|
|
CAR
|
|
CLOCK
|
|
CONFIRMATION_NUMBER_ICON
|
|
DOLLAR
|
|
DESCRIPTION
|
|
EMAIL
|
|
EVENT_PERFORMER
|
|
EVENT_SEAT
|
|
FLIGHT_ARRIVAL
|
|
FLIGHT_DEPARTURE
|
|
HOTEL
|
|
HOTEL_ROOM_TYPE
|
|
INVITE
|
|
MAP_PIN
|
|
MEMBERSHIP
|
|
MULTIPLE_PEOPLE
|
|
OFFER
|
|
PERSON
|
|
PHONE
|
|
RESTAURANT_ICON
|
|
SHOPPING_CART
|
|
STAR
|
|
STORE
|
|
TICKET
|
|
TRAIN
|
|
VIDEO_CAMERA
|
|
VIDEO_PLAY
|
按鈕
按鈕。可以是文字按鈕或圖片按鈕。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位
|
|
textButton
|
含有文字和 |
imageButton
|
含有圖片和 |
TextButton
含有文字和 onclick
動作的按鈕。
JSON 表示法 |
---|
{
"text": string,
"onClick": {
object (
|
欄位 | |
---|---|
text
|
按鈕文字。 |
onClick
|
按鈕的 |
ImageButton
含有 onclick
動作的圖片按鈕。
JSON 表示法 |
---|
{ "onClick": { object ( |
欄位 | |
---|---|
onClick
|
|
name
|
這個 |
聯集欄位 icons 。您可以使用 Icon
enum 或網址指定圖示。icons 只能採用下列其中一種設定: |
|
icon
|
|
iconUrl
|
網址指定的圖示。 |
CardAction
資訊卡動作是與資訊卡相關的動作。對於發票資訊卡,一般動作如下:刪除月結單、電子郵件月結單,或在瀏覽器中開啟月結單。
Google Chat 應用程式不支援這項功能。
JSON 表示法 |
---|
{
"actionLabel": string,
"onClick": {
object (
|
欄位 | |
---|---|
actionLabel
|
用來在動作選單項目中顯示的標籤。 |
onClick
|
此操作項目的 onon 動作。 |