Button

使用者可點選的文字、圖示或文字和圖示按鈕。如需 Google Chat 應用程式的範例，請參閱「新增按鈕」。

如要將圖片設為可點選的按鈕，請指定 Image (而非 ImageComponent)，並設定 onClick 動作。

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

JSON 表示法 
{
  "text": string,
  "icon": {
    object (Icon)
  },
  "color": {
    object (Color)
  },
  "onClick": {
    object (OnClick)
  },
  "disabled": boolean,
  "altText": string,
  "type": enum (Type)
}
欄位
text

string

按鈕內顯示的文字。
icon

object (Icon)

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

object (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

object (OnClick)

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

boolean

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

string

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

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

enum (Type)

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

類型

(選用步驟) 按鈕的類型。如果設定 color 欄位，type 會強制設為 FILLED。

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

列舉
TYPE_UNSPECIFIED 請勿使用。未指明
OUTLINED 外框按鈕是中強調按鈕，通常包含重要動作，但不是 Chat 應用程式或外掛程式中的主要動作。
FILLED 填滿按鈕的容器會填滿單色。這種按鈕的視覺效果最強烈，建議用於 Chat 擴充應用程式或外掛程式中的重要和主要動作。
FILLED_TONAL 填滿色調按鈕是介於填滿按鈕和外框按鈕之間的替代方案。如果優先順序較低的按鈕需要比外框按鈕更醒目，就很適合使用這類按鈕。
BORDERLESS 按鈕在預設狀態下沒有隱形容器。通常用於優先順序最低的操作，特別是呈現多個選項時。