Package google.apps.card.v1

string

在含有元素的項目遭到點選或以其他方式啟用時，要叫用的自訂函式。

如需使用範例，請參閱「讀取表單資料」。

ActionParameter

動作參數清單。

LoadIndicator

指定動作在呼叫動作時顯示的載入指標。

bool

指出表單值是否會在動作完成後保留。預設值為 false。

如果為 true，觸發動作後表單值會保留。如要讓使用者在處理動作時進行變更，請將 LoadIndicator 設為 NONE。如果是 Chat 應用程式中的資訊卡訊息，您也必須將動作的 ResponseType 設為 UPDATE_MESSAGE，並使用包含該動作的資訊卡中的相同 card_id。

如果為 false，系統會在觸發動作時清除表單值。如要防止使用者在處理動作時進行變更，請將 LoadIndicator 設為 SPINNER。

Interaction

(選用步驟) 開啟對話方塊時為必填。

使用者與應用程式互動時 (例如點選資訊卡訊息中的按鈕) 應執行的動作。

如未指定，應用程式會照常執行 action (例如開啟連結或執行函式) 來回應。

指定 interaction 後，應用程式就能以特殊互動方式回應。舉例來說，如果將 interaction 設為 OPEN_DIALOG，應用程式就能開啟對話方塊。如有指定，系統就不會顯示載入指標。如果為外掛程式指定，系統會移除整張資訊卡，且不會在用戶端顯示任何內容。

適用於 Google Chat 應用程式，不適用於 Google Workspace 外掛程式。

string

(選用步驟) 請在這個清單中填入這個動作需要的小工具名稱，才能有效提交。

如果叫用這項動作時，這裡列出的小工具沒有值，系統就會中止表單提交作業。

適用於 Google Chat 擴充應用程式和 Google Workspace 外掛程式。

bool

(選用步驟) 如果為 true，則這項動作會將所有小工具視為必要。

適用於 Google Chat 擴充應用程式和 Google Workspace 外掛程式。

string

動作指令碼的參數名稱。

string

參數值。

BorderType

框線類型。

Color

類型為 BORDER_TYPE_STROKE 時要使用的顏色。

如要設定筆觸顏色，請為 red、green 和 blue 欄位指定值。值必須是介於 0 和 1 之間的浮點數，以 RGB 顏色值為準，其中 0 (0/255) 代表沒有顏色，1 (255/255) 代表顏色強度最大。

舉例來說，以下程式碼會將顏色設為最高強度的紅色：

"color": {    "red": 1,    "green": 0,    "blue": 0, } 

筆觸顏色無法使用 alpha 欄位。如果指定這個欄位，系統會忽略。

int32

邊框的圓角半徑。

string

按鈕內顯示的文字。

Icon

按鈕內顯示的圖示。如果同時設定 icon 和 text，圖示會顯示在文字前方。

Color

(選用步驟) 按鈕的顏色。如果設定了這個屬性，按鈕 type 會設為 FILLED，而 text 和 icon 欄位的顏色會設為對比色，方便使用者閱讀。舉例來說，如果按鈕顏色設為藍色，按鈕中的任何文字或圖示都會設為白色。

如要設定按鈕顏色，請為 red、green 和 blue 欄位指定值。值必須是介於 0 和 1 之間的浮點數，以 RGB 顏色值為準，其中 0 (0/255) 代表沒有顏色，1 (255/255) 代表顏色強度最大。

舉例來說，以下程式碼會將顏色設為最高強度的紅色：

"color": {    "red": 1,    "green": 0,    "blue": 0, } 

按鈕顏色無法使用 alpha 欄位。如果指定這個欄位，系統會忽略。

OnClick

必要欄位。使用者點選按鈕時要執行的動作，例如開啟超連結或執行自訂函式。

bool

如果 true，按鈕會顯示為非使用中狀態，且不會回應使用者動作。

string

用於無障礙功能的替代文字。

設定說明文字，讓使用者瞭解按鈕的功能。舉例來說，如果按鈕會開啟超連結，您可以寫下：「開啟新的瀏覽器分頁，並前往 https://developers.google.com/workspace/chat" 的 Google Chat 開發人員說明文件」。

Type

(選用步驟) 按鈕類型。如未設定，按鈕類型會預設為 OUTLINED。如果設定 color 欄位，按鈕類型會強制設為 FILLED，且系統會忽略為這個欄位設定的任何值。

Button

按鈕陣列。

CardHeader

資訊卡的標題。標題通常包含開頭圖片和標題。標題一律會顯示在資訊卡頂端。

Section

包含小工具集合。每個區段都有自己的選用標題。各節之間會以分隔線區隔。如需 Google Chat 應用程式的範例，請參閱「定義資訊卡的區段」。

DividerStyle

標題、區段和頁尾之間的分隔線樣式。

CardAction

卡片的動作。動作會新增至資訊卡的工具列選單。

適用於 Google Workspace 外掛程式，不適用於 Google Chat 應用程式。

舉例來說，下列 JSON 會建立含有 Settings 和 Send Feedback 選項的資訊卡動作選單：

"cardActions": [   {     "actionLabel": "Settings",     "onClick": {       "action": {         "functionName": "goToView",         "parameters": [           {             "key": "viewType",             "value": "SETTING"          }         ],         "loadIndicator": "LoadIndicator.SPINNER"       }     }   },   {     "actionLabel": "Send Feedback",     "onClick": {       "openLink": {         "url": "https://example.com/feedback"       }     }   } ] 

string

資訊卡的名稱。在卡片導覽中做為卡片 ID。

適用於 Google Workspace 外掛程式，不適用於 Google Chat 應用程式。

CardFixedFooter

顯示在此資訊卡底部的固定頁尾。

如果設定 fixedFooter 但未指定 primaryButton 或 secondaryButton，就會發生錯誤。如果是 Chat 應用程式，您可以在對話方塊中使用固定頁尾，但無法在訊息卡片中使用。

適用於 Google Chat 擴充應用程式和 Google Workspace 外掛程式。

DisplayStyle

在 Google Workspace 外掛程式中，設定 peekCardHeader 的顯示屬性。

適用於 Google Workspace 外掛程式，不適用於 Google Chat 應用程式。

CardHeader

顯示脈絡內容時，概覽資訊卡標題會做為預留位置，方便使用者在首頁資訊卡和脈絡資訊卡之間向前瀏覽。

適用於 Google Workspace 外掛程式，不適用於 Google Chat 應用程式。

ExpressionData

資訊卡的運算式資料。

適用於擴充 Google Workspace 流程的 Google Workspace 外掛程式，這類外掛程式隨附於 Gemini Alpha 版計畫中。不適用於 Google Chat 應用程式。

string

顯示為動作選單項目的標籤。

OnClick

這個待辦事項的 onClick 動作。

Button

固定式頁尾的主要按鈕。按鈕必須是文字按鈕，且已設定文字和顏色。

Button

固定式頁尾的次要按鈕。按鈕必須是文字按鈕，且已設定文字和顏色。如果設定 secondaryButton，則必須一併設定 primaryButton。

string

必要欄位。資訊卡標題。標題的高度固定，如果同時指定標題和副標題，兩者各佔一行。如果只指定標題，標題會佔用兩行。

string

資訊卡標題的副標題。如果指定，會顯示在 title 下方的單獨一行。

ImageType

用於裁剪圖片的形狀。

適用於 Google Chat 擴充應用程式和 Google Workspace 外掛程式。

string

資訊卡標題中的圖片 HTTPS 網址。

string

這張圖片的替代文字，用於無障礙功能。

TextParagraph

文字段落小工具。

ButtonList

按鈕清單小工具。

Image

圖片小工具。

string

顯示在區段頂端的文字。支援簡單的 HTML 格式文字。如要進一步瞭解如何設定文字格式，請參閱「在 Google Chat 應用程式中設定文字格式」和「在 Google Workspace 外掛程式中設定文字格式」。

Widget

該區段中的所有小工具。至少要包含一個小工具。

bool

指出這個區塊是否可收合。

可收合區塊會隱藏部分或所有小工具，但使用者可以點選「顯示更多」展開區塊，顯示隱藏的小工具。如要再次隱藏小工具，請按一下「顯示較少」。

如要判斷隱藏哪些小工具，請指定 uncollapsibleWidgetsCount。

int32

即使部分內容已收合，仍會顯示的不可收合小工具數量。

舉例來說，如果某個區塊包含五個小工具，且 uncollapsibleWidgetsCount 設為 2，系統一律會顯示前兩個小工具，並預設收合後三個小工具。只有在 collapsible 為 true 時，系統才會將 uncollapsibleWidgetsCount 納入考量。

string

指派給區段的專屬 ID，用於識別要變動的區段。ID 長度不得超過 64 個字元，且格式應為 [a-zA-Z0-9-]+。

適用於擴充 Google Workspace 流程的 Google Workspace 外掛程式，這類外掛程式隨附於 Gemini Alpha 版計畫中。不適用於 Google Chat 應用程式。

CollapseControl

(選用步驟) 定義區段的展開和收合按鈕。只有在可收合的區塊中，才會顯示這個按鈕。如果未設定這個欄位，系統會使用預設按鈕。

CarouselCard

輪轉介面中包含的資訊卡清單。

NestedWidget

輪轉介面資訊卡中顯示的小工具清單。小工具會按照指定順序顯示。

NestedWidget

輪轉介面資訊卡底部會顯示小工具清單。小工具會按照指定順序顯示。

Icon

圖示圖片。如果同時設定 icon 和 text，圖示會顯示在文字前方。

string

顯示在晶片內的文字。

OnClick

(選用步驟) 使用者點選方塊時要執行的動作，例如開啟超連結或執行自訂函式。

bool

晶片是否處於啟用狀態，並回應使用者動作。預設為 true。已淘汰，改用 disabled。

bool

晶片是否處於非使用中狀態，並忽略使用者動作。預設值為 false。

string

用於無障礙功能的替代文字。

設定說明文字，讓使用者瞭解晶片的功能。舉例來說，如果晶片會開啟超連結，請寫下：「開啟新的瀏覽器分頁，並前往 https://developers.google.com/workspace/chat" 的 Google Chat 開發人員說明文件」。

Layout

指定方塊清單版面配置。

Chip

晶片陣列。

HorizontalAlignment

展開和收合按鈕的水平對齊方式。

Button

(選用步驟) 定義可自訂按鈕，展開該部分。expandButton 和 collapseButton 欄位都必須設定。只設定一個欄位不會生效。如果未設定這個欄位，系統會使用預設按鈕。

Button

(選用步驟) 定義可自訂的按鈕，用來收合該部分。expandButton 和 collapseButton 欄位都必須設定。只設定一個欄位不會生效。如果未設定這個欄位，系統會使用預設按鈕。

Column

資料欄陣列。資訊卡或對話方塊最多可包含 2 欄。

HorizontalSizeStyle

指定資料欄填滿卡片寬度的方式。

HorizontalAlignment

指定小工具在欄中靠左、靠右或置中對齊。

VerticalAlignment

指定小工具是否要靠上、靠下或置中對齊資料欄。

Widgets

資料欄中包含的小工具陣列。小工具會按照指定順序顯示。

TextParagraph

TextParagraph小工具。

Image

Image小工具。

DecoratedText

DecoratedText小工具。

ButtonList

ButtonList小工具。

TextInput

TextInput小工具。

SelectionInput

SelectionInput小工具。

DateTimePicker

DateTimePicker小工具。

ChipList

ChipList小工具。

string

ActionRule 的專屬 ID。

ExpressionDataCondition

由運算式資料決定的條件。

ConditionType

條件類型。

HostAppDataActionMarkup

定義如何更新 Google Workspace 資料。

Action

資料來自遠端資料供應商。

PlatformDataSource

資料來自 Google Workspace 應用程式。

string

表單輸入事件中 DateTimePicker 的識別名稱。

如要瞭解如何使用表單輸入內容，請參閱「接收表單資料」。

string

提示使用者輸入日期、時間或日期和時間的文字。舉例來說，如果使用者要預約時間，請使用 Appointment date 或 Appointment date and time 等標籤。

DateTimePickerType

小工具是否支援輸入日期、時間或日期和時間。

int64

小工具中顯示的預設值，以自 Unix Epoch 時間起算的毫秒為單位。

根據挑選器類型 (DateTimePickerType) 指定值：

• DATE_AND_TIME：世界標準時間的日曆日期和時間。舉例來說，如要表示 2023 年 1 月 1 日世界標準時間中午 12 點，請使用 1672574400000。
• DATE_ONLY：世界標準時間 00:00:00 的日曆日期。舉例來說，如要表示 2023 年 1 月 1 日，請使用 1672531200000。
• TIME_ONLY：世界標準時間。舉例來說，如要表示下午 12:00，請使用 43200000 (或 12 * 60 * 60 * 1000)。

int32

代表時區與世界標準時間的時差 (以分鐘為單位) 的數字。如果已設定，系統會以指定時區顯示 value_ms_epoch。如未設定，系統會預設為使用者的時區設定。

Action

使用者在 DateTimePicker 介面中點選「儲存」或「清除」時觸發。

HostAppDataSourceMarkup

Google Workspace 主機應用程式專屬的資料來源，例如 Gmail 電子郵件、Google 日曆活動或 Google Chat 訊息。

適用於擴充 Google Workspace 流程的 Google Workspace 外掛程式，這類外掛程式隨附於 Gemini Alpha 版計畫中。不適用於 Google Chat 應用程式。

Icon

已淘汰，改用 startIcon。

Icon

顯示在文字前方的圖示。

VerticalAlignment

(選用步驟) 開始圖示的垂直對齊方式。如未設定，圖示會垂直置中。

適用於 Google Chat 應用程式，不適用於 Google Workspace 外掛程式。

string

顯示在 text 上方的文字。一律會截斷。

TextParagraph

TextParagraph 的等效值 top_label。一律會截斷。可進行比 top_label 更複雜的格式設定。

適用於 Google Chat 應用程式，不適用於 Google Workspace 外掛程式。

string

必要欄位。主要文字。

支援簡單的格式設定。如要進一步瞭解如何設定文字格式，請參閱「在 Google Chat 應用程式中設定文字格式」和「在 Google Workspace 外掛程式中設定文字格式」。

TextParagraph

TextParagraph 的等效值 text。可進行比 text 更複雜的格式設定。

適用於 Google Chat 應用程式，不適用於 Google Workspace 外掛程式。

bool

自動換行設定。如為 true，文字會換行並顯示在多行中。否則文字會遭到截斷。

僅適用於 text，不適用於 topLabel 和 bottomLabel。

string

顯示在 text 下方的文字。一律換行。

TextParagraph

TextParagraph 的等效值 bottom_label。一律換行。可進行比 bottom_label 更複雜的格式設定。

適用於 Google Chat 應用程式，不適用於 Google Workspace 外掛程式。

OnClick

使用者點選 topLabel 或 bottomLabel 時，就會觸發這項動作。

Button

使用者可點選這個按鈕來觸發動作。

SwitchControl

使用者可點選切換鈕小工具來變更狀態及觸發動作。

Icon

文字後方顯示的圖示。

支援內建和自訂圖示。

string

表單輸入事件中用來識別切換鈕小工具的名稱。

如要瞭解如何使用表單輸入內容，請參閱「接收表單資料」。

string

使用者輸入的值，會以表單輸入事件的形式傳回。

如要瞭解如何使用表單輸入內容，請參閱「接收表單資料」。

bool

選取切換鈕時，切換鈕會顯示 true。

Action

切換開關狀態時要執行的動作，例如要執行的函式。

ControlType

切換按鈕在使用者介面中的顯示方式。

適用於 Google Chat 擴充應用程式和 Google Workspace 外掛程式。

Action

如果是 Google Chat 外掛程式，則為關閉對話方塊的動作。

string

ActionRule 的專屬 ID。

Trigger

執行 EventAction 後觸發的觸發條件清單。

CommonWidgetAction

常見的小工具動作。

UpdateVisibilityAction

更新小工具顯示狀態的動作。

Visibility

新的瀏覽權限。

string

ExpressionData 的專屬 ID。

string

未編譯的運算式。

Condition

由運算式評估結果決定的條件清單。

EventAction

ExpressionData 可執行的動作清單。

Suggestions

string

這是無運算元的結構定義欄位，可能出現在標記中，用於語法檢查。

string

顯示在格線標題中的文字。

GridItem

要在格線中顯示的項目。

BorderStyle

要套用至每個格線項目的邊框樣式。

int32

要在格線中顯示的欄數。如未指定這個欄位，系統會使用預設值，而預設值會因格線顯示位置 (對話方塊與隨播廣告) 而異。

OnClick

每個個別格線項目都會重複使用這個回呼，但項目 ID 和項目清單中的索引會新增至回呼的參數。

string

這個格線項目的使用者指定 ID。這個 ID 會在上層格線的 onClick 回呼參數中傳回。

ImageComponent

顯示在格狀項目中的圖片。

string

格線項目的標題。

string

格線項目的子標題。

GridItemLayout

用於格線項目的版面配置。

string

(選用步驟) 無障礙圖示的說明。如未指定，則提供預設值 Button。最佳做法是為圖示顯示的內容設定實用說明，並視需要說明圖示的功能。例如 A user's account portrait 或 Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat。

如果圖示是在 Button 中設定，使用者將滑鼠游標懸停在按鈕上時，altText 會顯示為實用提示文字。不過，如果按鈕也設定了 text，系統就會忽略圖示的 altText。

ImageType

套用至圖片的裁剪樣式。在某些情況下，套用 CIRCLE 裁剪功能會導致圖片繪製的尺寸大於內建圖示。

string

顯示 Google Workspace 提供的內建圖示。

舉例來說，如要顯示飛機圖示，請指定 AIRPLANE。如果是公車，請指定 BUS。

如需支援圖示的完整清單，請參閱「內建圖示」。

string

顯示 HTTPS 網址代管的自訂圖示。

例如：

"iconUrl": "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png" 

支援的檔案類型包括 .png 和 .jpg。

MaterialIcon

顯示其中一個 Google Material Icons。

舉例來說，如要顯示核取方塊圖示，請使用

"materialIcon": {   "name": "check_box" } 

適用於 Google Chat 應用程式，不適用於 Google Workspace 外掛程式。

string

圖片的 HTTPS 網址。

例如：

https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png 

OnClick

使用者點按圖片時，點擊動作會觸發這項動作。

string

這張圖片的替代文字，用於無障礙功能。

string

圖片網址。

string

圖片的無障礙標籤。

ImageCropStyle

要套用至圖片的裁剪樣式。

BorderStyle

要套用至圖片的邊框樣式。

ImageCropType

裁剪類型。

double

如果裁剪類型為 RECTANGLE_CUSTOM，則使用的顯示比例。

舉例來說，以下是套用 16:9 長寬比的方法：

cropStyle {  "type": "RECTANGLE_CUSTOM",  "aspectRatio": 16/9 } 

string

要返回外掛程式的連結網址。

string

返回外掛程式的連結標題。

Card

顯示第三方服務連結相關資訊的資訊卡。

string

連結預覽智慧型方塊中顯示的標題。如果未設定，智慧型方塊會顯示 previewCard 的標題。

string

連結預覽畫面中顯示的標題。如未設定，連結預覽畫面會顯示 previewCard 的標頭。

string

Google Material Icon 中定義的圖示名稱，例如 check_box。系統會捨棄所有無效名稱，並替換成空白字串，導致圖示無法顯示。

bool

圖示是否會填滿。預設值為 false。

如要預覽不同的圖示設定，請前往 Google 字型圖示，然後調整「自訂」下方的設定。

int32

圖示的筆觸粗細。請從 {100、200、300、400、500、600、700} 中選擇。如未提供，預設值為 400。如果指定其他值，系統會使用預設值。

如要預覽不同的圖示設定，請前往 Google 字型圖示，然後調整「自訂」下方的設定。

int32

符號的粗細會受到權重和等級影響。調整等級比調整粗細更精細，對符號大小的影響較小。請從 {-25, 0, 200} 中選擇。如未提供，預設值為 0。如果指定其他值，系統會使用預設值。

如要預覽不同的圖示設定，請前往 Google 字型圖示，然後調整「自訂」下方的設定。

UpdateWidget

如果是 Google Chat 外掛程式，則會更新資訊卡或對話方塊中的小工具。

SelectionInputWidgetSuggestions

如果是 selectionInput 小工具，則是多選選單中的建議項目陣列。如果多選選單使用外部資料來源填入項目，小工具可以根據使用者在選單中輸入的內容，動態填入建議。詳情請參閱「收集 Google Chat 使用者的資訊」。

SelectionItem

使用者在多重選取選單中輸入內容後，系統會顯示可選取的項目陣列。

bool

彈出所有資訊卡，但根資訊卡除外。

bool

彈出一張卡片。

string

系統會彈出指定資訊卡名稱上方所有資訊卡。

Card

將卡片推送到卡片堆疊。

對於 Google Chat 中的對話方塊，開啟或更新對話方塊。

Card

更新頂端卡片，顯示新卡片，並保留已填寫的表單欄位值。如果欄位不對等，系統會捨棄值。

對於 Google Chat 中的對話方塊，開啟或更新對話方塊。

EndNavigation

如果是 Google Chat 外掛程式，則會關閉對話方塊。

string

要顯示的通知純文字，不含 HTML 標記。

Action

如果指定了這個 onClick，系統就會觸發動作。

OpenLink

如果指定了這個 onClick，系統就會觸發開啟連結動作。

Action

當動作需要開啟連結時，外掛程式會觸發這項動作。這與上述 open_link 的不同之處在於，這個 open_link 需要與伺服器通訊才能取得連結。因此，網頁用戶端必須先完成一些準備工作，才能收到開啟連結動作的回應。

適用於 Google Workspace 外掛程式，不適用於 Google Chat 應用程式。

Card

點按後，系統會將新卡片推送至卡片堆疊 (如有指定)。

適用於 Google Workspace 外掛程式，不適用於 Google Chat 應用程式。

OverflowMenu

如果指定此項，onClick 會開啟溢位選單。

string

要開啟的網址。

OpenAs

如何開啟連結。

適用於 Google Workspace 外掛程式，不適用於 Google Chat 應用程式。

OnClose

無論用戶端在開啟連結後忘記連結，還是觀察連結直到視窗關閉為止。

適用於 Google Workspace 外掛程式，不適用於 Google Chat 應用程式。

OverflowMenuItem

必要欄位。選單選項清單。

Icon

顯示在文字前方的圖示。

string

必要欄位。向使用者識別或說明項目的文字。

OnClick

必要欄位。選取選單選項時執行的動作。這個 OnClick 不可包含 OverflowMenu，任何指定的 OverflowMenu 都會遭到捨棄，且選單項目會停用。

bool

選單選項是否已停用。預設值為 false。

Action

外掛程式可用來更新 UI 的動作。

Google Chat 外掛程式。

HostAppActionMarkup

個別主機應用程式處理的動作。

string

這是無運算元的結構定義欄位，可能出現在標記中，用於語法檢查。

Navigation

推送、彈出或更新卡片。

Google Chat 外掛程式。

OpenLink

在新分頁或彈出式視窗中開啟目標連結。

Notification

使用者與資訊卡互動時，主機 Google Workspace 應用程式會顯示通知。

如果是 Google Chat 外掛程式，會在使用者提交並關閉對話方塊時顯示通知。

LinkPreview

這項功能適用於 Google 文件、Google 試算表和 Google 簡報。使用智慧型方塊和資訊卡預覽連結。詳情請參閱「使用智慧型方塊預覽連結」。

Link

這項功能適用於 Google 文件。從第三方資源傳回連結，並在主機應用程式中轉換為智慧型方塊。格式為包含一個項目的物件陣列。

詳情請參閱「從 @ 選單建立第三方資源」。

ModifyCard

如果是 Google Chat 外掛程式，則會根據使用者互動更新資訊卡。陣列只能包含單一物件。

string

必要欄位。在表單輸入事件中，用於識別選取輸入內容的名稱。

如要瞭解如何使用表單輸入內容，請參閱「接收表單資料」。

string

使用者介面中，顯示在選取輸入欄位上方的文字。

指定有助於使用者輸入應用程式所需資訊的文字。舉例來說，如果使用者要從下拉式選單中選取工作單的緊急程度，標籤可能是「緊急程度」或「選取緊急程度」。

SelectionType

在 SelectionInput 小工具中向使用者顯示的項目類型。選取類型支援不同類型的互動。舉例來說，使用者可以選取一或多個核取方塊，但只能從下拉式選單中選取一個值。

SelectionItem

可選取項目的陣列。例如圓形按鈕或核取方塊的陣列。最多可支援 100 個項目。

Action

如果指定，表單會在選取內容變更時提交。如未指定，則必須指定提交表單的按鈕。

如要瞭解如何使用表單輸入內容，請參閱「接收表單資料」。

int32

如果是多選單，這是指使用者輸入的文字字元數，之後選單就會傳回建議的選取項目。

如未設定，多選功能表會使用下列預設值：

• 如果選單使用 SelectionInput 項目靜態陣列，則預設為 0 個字元，並立即從陣列填入項目。
• 如果選單使用動態資料來源 (multi_select_data_source)，系統預設會在使用者輸入 3 個字元後，查詢資料來源並傳回建議項目。

DataSourceConfig

(選用步驟) 選取控制項的資料來源設定。這個欄位可更精細地控管資料來源。

如果指定，系統會忽略 multi_select_max_selected_items 欄位、multi_select_min_query_length 欄位、external_data_source 欄位和 platform_data_source 欄位。

適用於擴充 Google Workspace 流程的 Google Workspace 外掛程式，這類外掛程式隨附於 Gemini Alpha 版計畫中。不適用於 Google Chat 應用程式。

int32

如果是多選選單，這是使用者可選取的項目數量上限。最小值為 1 個項目。如未指定，預設為 3 個項目。

string

(選用步驟) 顯示在選取輸入欄位下方的文字，提示使用者輸入特定值，藉此提供協助。這段文字會一直顯示。

適用於擴充 Google Workspace 流程的 Google Workspace 外掛程式，這類外掛程式隨附於 Gemini Alpha 版計畫中。不適用於 Google Chat 應用程式。

Action

外部資料來源，例如關聯式資料庫。

PlatformDataSource

Google Workspace 的資料來源。

CommonDataSource

所有 Google Workspace 應用程式共用的資料來源，例如 Google Workspace 機構中的使用者。

HostAppDataSourceMarkup

Google Workspace 主機應用程式專屬的資料來源，例如 Google Chat 中的聊天室。

這個欄位支援 Google API 用戶端程式庫，但 Cloud 用戶端程式庫不支援。詳情請參閱「安裝用戶端程式庫」。

string

向使用者識別或說明項目的文字。

string

與這個項目相關聯的值。用戶應將此值做為表單輸入值。

如要瞭解如何使用表單輸入內容，請參閱「接收表單資料」。

bool

項目是否預設為選取狀態。如果選取輸入內容只接受一個值 (例如圓形按鈕或下拉式選單)，請只為一個項目設定這個欄位。

string

如果是多選式選單，則為顯示在項目 text 欄位下方的文字說明或標籤。

string

RenderActions

一組算繪指令，可指示資訊卡執行動作，和/或指示外掛程式主機應用程式執行應用程式專屬動作。

bool

資訊卡的狀態是否已變更，以及現有資訊卡中的資料是否過時。

string

這是無運算元的結構定義欄位，可能出現在標記中，用於語法檢查。

SuggestionItem

用於文字輸入欄位自動完成建議的建議清單。

string

文字輸入欄位的建議輸入值。這與使用者自行輸入的內容相同。

string

表單輸入事件中用來識別文字輸入內容的名稱。

如要瞭解如何使用表單輸入內容，請參閱「接收表單資料」。

string

使用者介面中文字輸入欄位上方的文字。

指定有助於使用者輸入應用程式所需資訊的文字。舉例來說，如果您要詢問對方的姓名，但特別需要對方的姓氏，請寫下 surname，而不是 name。

如果未指定 hintText，則為必要欄位。否則為選填。

string

顯示在文字輸入欄位下方的文字，提示使用者輸入特定值，藉此提供協助。這段文字會一直顯示。

如果未指定 label，則為必要欄位。否則為選填。

string

使用者輸入的值，會以表單輸入事件的形式傳回。

如要瞭解如何使用表單輸入內容，請參閱「接收表單資料」。

Type

文字輸入欄位在使用者介面中的顯示方式。例如欄位是單行還是多行。

Action

當文字輸入欄位發生變更時，應執行的動作。例如使用者在欄位中新增或刪除文字。

例如執行自訂函式，或在 Google Chat 中開啟對話方塊。

Suggestions

使用者可輸入的建議值。使用者點按文字輸入欄位時，系統會顯示這些值。使用者輸入內容時，系統會動態篩選建議值，找出與使用者輸入內容相符的值。

舉例來說，程式設計語言的文字輸入欄位可能會建議 Java、JavaScript、Python 和 C++。使用者開始輸入 Jav 時，建議清單會經過篩選，只顯示 Java 和 JavaScript。

建議值可引導使用者輸入應用程式可解讀的值。提到 JavaScript 時，部分使用者可能會輸入 javascript，其他使用者則可能輸入 java script。建議JavaScript可讓使用者與應用程式互動的方式標準化。

指定時，TextInput.type 一律為 SINGLE_LINE，即使設為 MULTIPLE_LINE 也是如此。

適用於 Google Chat 擴充應用程式和 Google Workspace 外掛程式。

Action

(選用步驟) 指定文字輸入欄位向與其互動的使用者提供建議時，要執行的動作。

如未指定，建議會由 initialSuggestions 設定，並由用戶端處理。

如果指定，應用程式會採取這裡指定的動作，例如執行自訂函式。

適用於 Google Workspace 外掛程式，不適用於 Google Chat 應用程式。

Validation

指定這個文字欄位必須通過的輸入格式驗證。

適用於 Google Chat 擴充應用程式和 Google Workspace 外掛程式。

string

欄位空白時，文字輸入欄位中顯示的文字。使用這段文字提示使用者輸入值。例如 Enter a number from 0 to 100。

適用於 Google Chat 應用程式，不適用於 Google Workspace 外掛程式。

HostAppDataSourceMarkup

Google Workspace 主機應用程式專屬的資料來源，例如 Gmail 電子郵件、Google 日曆活動或 Google Chat 訊息。

適用於擴充 Google Workspace 流程的 Google Workspace 外掛程式，這類外掛程式隨附於 Gemini Alpha 版計畫中。不適用於 Google Chat 應用程式。

string

小工具中顯示的文字。

int32

小工具中顯示的文字行數上限。如果文字超過指定行數上限，多餘的內容會隱藏在「顯示更多」按鈕後方。如果文字等於或短於指定行數上限，系統就不會顯示「顯示更多」按鈕。

預設值為 0，此時會顯示所有內容。系統會忽略負值。

TextSyntax

文字的語法。如未設定，系統會將文字轉譯為 HTML。

適用於 Google Chat 應用程式，不適用於 Google Workspace 外掛程式。

string

ActionRule 的專屬 ID。

int32

指定文字輸入小工具的字元限制。請注意，這項屬性僅適用於文字輸入，其他小工具會忽略這項屬性。

適用於 Google Chat 擴充應用程式和 Google Workspace 外掛程式。

InputType

指定輸入小工具的類型。

適用於 Google Chat 擴充應用程式和 Google Workspace 外掛程式。

HorizontalAlignment

指定小工具在欄中靠左、靠右或置中對齊。

string

指派給小工具的專屬 ID，用於識別要變更的小工具。ID 長度不得超過 64 個字元，且格式應為 [a-zA-Z0-9-]+ 和。

適用於擴充 Google Workspace 流程的 Google Workspace 外掛程式，這類外掛程式隨附於 Gemini Alpha 版計畫中。不適用於 Google Chat 應用程式。

Visibility

指定小工具是否顯示或隱藏。預設值為 VISIBLE。

適用於擴充 Google Workspace 流程的 Google Workspace 外掛程式，這類外掛程式隨附於 Gemini Alpha 版計畫中。不適用於 Google Chat 應用程式。

EventAction

指定可在小工具上執行的事件動作。

適用於擴充 Google Workspace 流程的 Google Workspace 外掛程式，這類外掛程式隨附於 Gemini Alpha 版計畫中。不適用於 Google Chat 應用程式。

TextParagraph

顯示一段文字。支援簡單的 HTML 格式文字。如要進一步瞭解如何設定文字格式，請參閱「在 Google Chat 應用程式中設定文字格式」和「在 Google Workspace 外掛程式中設定文字格式」。

舉例來說，下列 JSON 會建立粗體文字：

"textParagraph": {   "text": "  <b>bold text</b>" } 

Image

顯示圖片。

舉例來說，下列 JSON 會建立含有替代文字的圖片：

"image": {   "imageUrl":   "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",   "altText": "Chat app avatar" } 

DecoratedText

顯示裝飾文字項目。

舉例來說，下列 JSON 會建立顯示電子郵件地址的裝飾文字小工具：

"decoratedText": {   "icon": {     "knownIcon": "EMAIL"   },   "topLabel": "Email Address",   "text": "[email protected]",   "bottomLabel": "This is a new Email address!",   "switchControl": {     "name": "has_send_welcome_email_to_sasha",     "selected": false,     "controlType": "CHECKBOX"   } } 

ButtonList

按鈕清單。

舉例來說，下列 JSON 會建立兩個按鈕。第一個是藍色文字按鈕，第二個是開啟連結的圖片按鈕：

"buttonList": {   "buttons": [     {       "text": "Edit",       "color": {         "red": 0,         "green": 0,         "blue": 1,       },       "disabled": true,     },     {       "icon": {         "knownIcon": "INVITE",         "altText": "check calendar"       },       "onClick": {         "openLink": {           "url": "https://example.com/calendar"         }       }     }   ] } 

TextInput

顯示使用者可輸入文字的文字方塊。

舉例來說，下列 JSON 會建立電子郵件地址的文字輸入內容：

"textInput": {   "name": "mailing_address",   "label": "Mailing Address" } 

以下是另一個範例，說明如何使用 JSON 為程式設計語言建立文字輸入內容，並提供靜態建議：

"textInput": {   "name": "preferred_programing_language",   "label": "Preferred Language",   "initialSuggestions": {     "items": [       {         "text": "C++"       },       {         "text": "Java"       },       {         "text": "JavaScript"       },       {         "text": "Python"       }     ]   } } 

SelectionInput

顯示選取控制項，供使用者選取項目。選取控制項可以是核取方塊、圓形按鈕、切換按鈕或下拉式選單。

舉例來說，下列 JSON 會建立下拉式選單，供使用者選擇尺寸：

"selectionInput": {   "name": "size",   "label": "Size"   "type": "DROPDOWN",   "items": [     {       "text": "S",       "value": "small",       "selected": false     },     {       "text": "M",       "value": "medium",       "selected": true     },     {       "text": "L",       "value": "large",       "selected": false     },     {       "text": "XL",       "value": "extra_large",       "selected": false     }   ] } 

DateTimePicker

顯示小工具，讓使用者輸入日期、時間或日期和時間。

舉例來說，下列 JSON 會建立日期時間挑選器，用於安排預約時間：

"dateTimePicker": {   "name": "appointment_time",   "label": "Book your appointment at:",   "type": "DATE_AND_TIME",   "valueMsEpoch": 796435200000 } 

Divider

在小工具之間顯示水平分隔線。

舉例來說，下列 JSON 會建立分隔線：

"divider": { } 

Grid

顯示包含一系列項目的格線。

格線支援任意數量的欄和項目。列數取決於項目數量上限除以欄數。如果格線有 10 個項目和 2 欄，就會有 5 列。如果格線有 11 個項目和 2 欄，則會有 6 列。

適用於 Google Chat 擴充應用程式和 Google Workspace 外掛程式。

舉例來說，下列 JSON 會建立含有單一項目的 2 欄格線：

"grid": {   "title": "A fine collection of items",   "columnCount": 2,   "borderStyle": {     "type": "STROKE",     "cornerRadius": 4   },   "items": [     {       "image": {         "imageUri": "https://www.example.com/image.png",         "cropStyle": {           "type": "SQUARE"         },         "borderStyle": {           "type": "STROKE"         }       },       "title": "An item",       "textAlignment": "CENTER"     }   ],   "onClick": {     "openLink": {       "url": "https://www.example.com"     }   } } 

Columns

最多可顯示 2 欄。

如要加入超過 2 個資料欄或使用資料列，請使用 Grid 小工具。

舉例來說，下列 JSON 會建立 2 個資料欄，每個資料欄都包含文字段落：

"columns": {   "columnItems": [     {       "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",       "horizontalAlignment": "CENTER",       "verticalAlignment": "CENTER",       "widgets": [         {           "textParagraph": {             "text": "First column text paragraph"           }         }       ]     },     {       "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",       "horizontalAlignment": "CENTER",       "verticalAlignment": "CENTER",       "widgets": [         {           "textParagraph": {             "text": "Second column text paragraph"           }         }       ]     }   ] } 

Carousel

輪轉介面包含一系列巢狀小工具。舉例來說，這是包含兩個段落的輪轉介面 JSON 表示法。

{   "widgets": [     {       "textParagraph": {         "text": "First text paragraph in the carousel."       }     },     {       "textParagraph": {         "text": "Second text paragraph in the carousel."       }     }   ] } 

ChipList

方塊清單。

舉例來說，下列 JSON 會建立兩個動態磚。第一個是文字資訊方塊，第二個是開啟連結的圖示資訊方塊：

"chipList": {   "chips": [     {       "text": "Edit",       "disabled": true,     },     {       "icon": {         "knownIcon": "INVITE",         "altText": "check calendar"       },       "onClick": {         "openLink": {           "url": "https://example.com/calendar"         }       }     }   ] }