Cards v2

{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string,
  "fixedFooter": {
    object (CardFixedFooter)
  },
  "displayStyle": enum (DisplayStyle),
  "peekCardHeader": {
    object (CardHeader)
  }
}

object (CardHeader)

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

object (Section)

包含一系列小工具。每個版面都有自己的選用標題。系統會以分隔線分隔多個區段。

object (CardAction)

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

Chat 應用程式資訊卡沒有工具列，因此 Chat 應用程式不支援 cardActions[]。

舉例來說，下列 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。

Chat 應用程式不支援資訊卡導覽功能，因此會忽略這個欄位。

object (CardFixedFooter)

這張卡片底部顯示的固定頁尾。

設定 fixedFooter 時，如未指定 primaryButton 或 secondaryButton，就會發生錯誤。

適用於 Google Workspace 外掛程式和即時通訊應用程式。如果是 Chat 應用程式，您可以在對話方塊中使用固定的頁尾，但不得用於資訊卡訊息。

enum (DisplayStyle)

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

Chat 應用程式不支援這項功能。

object (CardHeader)

顯示內容時，版資訊卡標頭會做為預留位置，讓使用者在首頁資訊卡與內容資訊卡之間來回瀏覽。

Chat 應用程式不支援這項功能。

{
  "title": string,
  "subtitle": string,
  "imageType": enum (ImageType),
  "imageUrl": string,
  "imageAltText": string
}

string

必要欄位。資訊卡標題的標題。標題的固定高度：如果同時指定標題和副標題，每個標題都必須佔一行。如果僅指定標題，則兩行會佔用兩行。

string

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

enum (ImageType)

用來裁剪圖片的形狀。

string

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

string

本圖片顯示的無障礙文字。

{
  "header": string,
  "widgets": [
    {
      object (Widget)
    }
  ],
  "collapsible": boolean,
  "uncollapsibleWidgetsCount": integer
}

string

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

object (Widget)

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

boolean

指出這個部分是否可收合。

可收合的部分會隱藏部分或所有小工具，但使用者可以按一下「顯示更多」，展開這個部分來顯示隱藏的小工具。使用者可以按一下「顯示較少」來隱藏小工具。

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

integer

無法收合的小工具數量，即使在收合區段時仍會顯示。

舉例來說，如果一個區段包含五個小工具，且 uncollapsibleWidgetsCount 設為 2，那麼前兩個小工具會一律顯示，而最後三個是收合。uncollapsibleWidgetsCount 只有在 collapsible 為 true 時，才會列入計算。

{
  "horizontalAlignment": enum (HorizontalAlignment),

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "decoratedText": {
    object (DecoratedText)
  },
  "buttonList": {
    object (ButtonList)
  },
  "textInput": {
    object (TextInput)
  },
  "selectionInput": {
    object (SelectionInput)
  },
  "dateTimePicker": {
    object (DateTimePicker)
  },
  "divider": {
    object (Divider)
  },
  "grid": {
    object (Grid)
  },
  "columns": {
    object (Columns)
  }
  // End of list of possible types for union field data.
}

enum (HorizontalAlignment)

指定小工具是否對齊資料欄的左側、中間或中間。

object (TextParagraph)

顯示文字段落。支援簡易 HTML 格式文字。想進一步瞭解文字格式，請參閱在 Google Chat 應用程式中設定文字格式和在 Google Workspace 外掛程式中設定文字格式。

例如，下列 JSON 會建立粗體文字：

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

object (Image)

顯示圖片。

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

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

object (DecoratedText)

顯示裝飾文字項目。

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

"decoratedText": {
  "icon": {
    "knownIcon": "EMAIL"
  },
  "topLabel": "Email Address",
  "text": "sasha@example.com",
  "bottomLabel": "This is a new Email address!",
  "switchControl": {
    "name": "has_send_welcome_email_to_sasha",
    "selected": false,
    "controlType": "CHECKBOX"
  }
}

object (ButtonList)

按鈕清單。

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

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

object (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"
      }
    ]
  }
}

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

object (DateTimePicker)

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

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

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

object (Divider)

顯示小工具的水平分隔線。

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

"divider": {
}

object (Grid)

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

格線支援不限數量的資料欄和項目。列數取決於數字的上方邊界除以欄數。內含 10 個項目和 2 欄的格線共有 5 列。網格內有 11 個項目和 2 欄，共有 6 列。

舉例來說，下列 JSON 會建立包含 1 個項目的 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"
    }
  }
}

object (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"
          }
        }
      ]
    }
  ]
}

{
  "text": string
}

string

小工具中顯示的文字。

{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "altText": string
}

string

代管圖片的 HTTPS 網址。

例如：

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

object (OnClick)

使用者按一下圖片即可觸發這個動作。

string

本圖片顯示的無障礙文字。

{

  // Union field data can be only one of the following:
  "action": {
    object (Action)
  },
  "openLink": {
    object (OpenLink)
  },
  "openDynamicLinkAction": {
    object (Action)
  },
  "card": {
    object (Card)
  }
  // End of list of possible types for union field data.
}

object (Action)

如果有指定，就會由此 onClick 觸發動作。

object (OpenLink)

指定時，此 onClick 會觸發開啟連結動作。

object (Action)

當需要開啟連結時，外掛程式會觸發這個動作。這與上述 openLink 不同，因為必須與伺服器對話才能取得連結。因此，網站用戶端必須先完成幾項準備工作，才能讓開放式連結動作回應傳回結果。

object (Card)

指定新的卡片後，系統會將新資訊卡推送至卡片堆疊。

支援 Google Workspace 外掛程式，但不支援 Chat 應用程式。

{
  "function": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ],
  "loadIndicator": enum (LoadIndicator),
  "persistValues": boolean,
  "interaction": enum (Interaction)
}

string

使用者點選或延遲啟用內含元素時，叫用的自訂函式。

如需用途範例，請參閱「建立互動式卡片」一文。

object (ActionParameter)

動作參數清單。

enum (LoadIndicator)

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

boolean

表示表單值在動作完成後是否持續存在。預設值為 false。

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

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

enum (Interaction)

選用設定。開啟對話方塊時為必填欄位。

回應使用者互動的方式，例如點選資訊卡訊息中的按鈕。

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

指定 interaction 後，應用程式就能以特殊的互動方式回應。舉例來說，如果將 interaction 設為 OPEN_DIALOG，應用程式就能開啟對話方塊。指定時，系統不會顯示載入指標。

支援 Chat 應用程式，但不支援 Google Workspace 外掛程式。指定外掛程式時，系統會移除整個資訊卡，用戶端也不會顯示任何內容。

{
  "key": string,
  "value": string
}

string

動作指令碼的參數名稱。

string

參數的值。

{
  "url": string,
  "openAs": enum (OpenAs),
  "onClose": enum (OnClose)
}

string

要開啟的網址。

enum (OpenAs)

如何開啟連結。Chat 應用程式不支援這項功能。

enum (OnClose)

用戶端在開啟連結後忘記關閉連結，還是在視窗關閉前觀察到該連結。Chat 應用程式不支援這項功能。

{
  "icon": {
    object (Icon)
  },
  "startIcon": {
    object (Icon)
  },
  "topLabel": string,
  "text": string,
  "wrapText": boolean,
  "bottomLabel": string,
  "onClick": {
    object (OnClick)
  },

  // Union field control can be only one of the following:
  "button": {
    object (Button)
  },
  "switchControl": {
    object (SwitchControl)
  },
  "endIcon": {
    object (Icon)
  }
  // End of list of possible types for union field control.
}

object (Icon)

已淘汰，並改用 startIcon。

object (Icon)

顯示在文字前方的圖示。

string

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

string

必要欄位。主要文字。

支援簡易格式。想進一步瞭解文字格式，請參閱在 Google Chat 應用程式中設定文字格式和在 Google Workspace 外掛程式中設定文字格式。

boolean

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

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

string

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

object (OnClick)

使用者按一下 topLabel 或 bottomLabel 時，就會觸發這項操作。

object (Button)

使用者可點選的按鈕觸發動作。

object (SwitchControl)

使用者可以按一下的切換小工具，用於變更狀態及觸發動作。

object (Icon)

文字後方顯示的圖示。

支援內建和自訂圖示。

{
  "altText": string,
  "imageType": enum (ImageType),

  // Union field icons can be only one of the following:
  "knownIcon": string,
  "iconUrl": string
  // End of list of possible types for union field icons.
}

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/chat

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

enum (ImageType)

套用至圖片的裁剪樣式。在某些情況下，套用 CIRCLE 裁剪會使圖像大於內建圖示。

string

顯示 Google Workspace 提供的其中一個內建圖示。

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

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

string

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

例如：

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

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

{
  "text": string,
  "icon": {
    object (Icon)
  },
  "color": {
    object (Color)
  },
  "onClick": {
    object (OnClick)
  },
  "disabled": boolean,
  "altText": string
}

string

按鈕中顯示的文字。

object (Icon)

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

object (Color)

如果設定了按鈕，按鈕會填入純底色，字型顏色也會改變，以便與背景顏色形成對比。例如，設定藍色背景可能會產生白色文字。

如未設定，圖片背景為白色，字型顏色為藍色。

以紅色、綠色和藍色表示，每個欄位的值都是兩種表示的 float 數字：介於 0 到 255 之間的數字除以 255 (153/255)，或是介於 0 到 1 (0.6) 之間的值。0 代表沒有顏色，1 或 255/255 則代表 RGB 量表上的完整顏色。

視需要設定 alpha，讓系統透過以下方程式設定透明度：

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

在 alpha 中，1 的值會是一個純色，而 0 的值則與完全透明的顏色對應。

舉例來說，下列顏色代表半透明的紅色：

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

object (OnClick)

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

boolean

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

string

無障礙工具使用的替代文字。

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

{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}

number

以顏色 [0, 1] 表示的值，在顏色中等於的紅色量。

number

以顏色 [0, 1] 為單位的值，在顏色中會以綠色值表示。

number

以顏色 [0, 1] 為單位的值，表示藍色值的數值。

number

這個顏色應套用至像素的分數。也就是說，最終像素顏色是由方程式定義：

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

也就是說，1.0 的值代表純色，而 0.0 值則對應至完全透明的顏色。這會使用包裝函式訊息，而非簡單的浮點純量，以便區分預設值和未設定的值。省略時，這個顏色物件會以純色表示 (如同 Alpha 值已明確指定為 1.0 的值)。

{
  "name": string,
  "value": string,
  "selected": boolean,
  "onChangeAction": {
    object (Action)
  },
  "controlType": enum (ControlType)
}

string

表單小工具在表單輸入事件中識別的名稱。

如要進一步瞭解如何使用表單輸入，請參閱接收表單資料。

string

使用者輸入的值，做為表單輸入事件的一部分傳回。

如要進一步瞭解如何使用表單輸入，請參閱接收表單資料。

boolean

如果選取 true，系統會切換切換按鈕。

object (Action)

切換狀態變更時要執行的動作，例如要執行哪些函式。

enum (ControlType)

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

{
  "buttons": [
    {
      object (Button)
    }
  ]
}

object (Button)

按鈕陣列。

{
  "name": string,
  "label": string,
  "hintText": string,
  "value": string,
  "type": enum (Type),
  "onChangeAction": {
    object (Action)
  },
  "initialSuggestions": {
    object (Suggestions)
  },
  "autoCompleteAction": {
    object (Action)
  }
}

string

文字輸入事件中以文字表示的名稱。

如要進一步瞭解如何使用表單輸入，請參閱接收表單資料。

string

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

指定文字，協助使用者輸入應用程式所需的資訊。舉例來說，如果您詢問某人的姓名卻需要特別的姓氏，請輸入 surname 而非 name。

如未指定 hintText，則為必要欄位。否則，此為選用欄位。

string

文字輸入欄位下方顯示的文字，提示使用者輸入特定值。這些文字會持續顯示。

如未指定 label，則為必要欄位。否則，此為選用欄位。

string

使用者輸入的值，做為表單輸入事件的一部分傳回。

如要進一步瞭解如何使用表單輸入，請參閱接收表單資料。

enum (Type)

文字輸入欄位在使用者介面中的樣貌。例如欄位為單行或多行。

object (Action)

文字輸入欄位中發生變更時該如何處理。例如為欄位新增或刪除文字。

具體措施包括執行自訂函式，或是在 Google Chat 中開啟對話方塊。

object (Suggestions)

使用者可輸入的值。當使用者在文字輸入欄位中按一下時，這些值就會出現。當使用者輸入搜尋字詞時，建議值會動態篩選出符合使用者輸入的內容。

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

建議值可協助引導使用者輸入應用程式可識別的值。參照 JavaScript 時，有些使用者可能會輸入 javascript 和 java script。建議 JavaScript 可以標準化使用者與應用程式互動的方式。

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

object (Action)

選用設定。指定當使用者在文字輸入欄位中提供互動建議時要採取的行動。

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

如果有指定，應用程式就會採用此處指定的動作，例如執行自訂函式。

支援 Google Workspace 外掛程式，但不支援 Chat 應用程式。

{
  "items": [
    {
      object (SuggestionItem)
    }
  ]
}

object (SuggestionItem)

文字輸入欄位中自動完成自動完成功能的建議清單。

{

  // Union field content can be only one of the following:
  "text": string
  // End of list of possible types for union field content.
}

string

文字輸入欄位的建議輸入值。這相當於使用者輸入的內容。

{
  "name": string,
  "label": string,
  "type": enum (SelectionType),
  "items": [
    {
      object (SelectionItem)
    }
  ],
  "onChangeAction": {
    object (Action)
  }
}

string

識別表單輸入事件中所選輸入內容的名稱。

如要進一步瞭解如何使用表單輸入，請參閱接收表單資料。

string

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

指定文字，協助使用者輸入應用程式所需的資訊。舉例來說，假設使用者從下拉式選單中選取了工作急迫性，標籤可能會為「緊急」或「選取緊急程度」。

enum (SelectionType)

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

object (SelectionItem)

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

object (Action)

如果指定，表單就會在選取後變更。如未指定，您必須指定用於提交表單的獨立按鈕。

如要進一步瞭解如何使用表單輸入，請參閱接收表單資料。

{
  "text": string,
  "value": string,
  "selected": boolean
}

string

用來識別或描述商品的文字。

string

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

如要進一步瞭解如何使用表單輸入，請參閱接收表單資料。

boolean

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

{
  "name": string,
  "label": string,
  "type": enum (DateTimePickerType),
  "valueMsEpoch": string,
  "timezoneOffsetDate": integer,
  "onChangeAction": {
    object (Action)
  }
}

string

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

如要進一步瞭解如何使用表單輸入，請參閱接收表單資料。

string

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

enum (DateTimePickerType)

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

string (int64 format)

小工具中顯示的預設值，以 Unix Epoch 紀元時間起算的毫秒數表示。

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

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

integer

代表時區與世界標準時間相差的時區 (以分鐘為單位)。設定完成後，valueMsEpoch 就會顯示指定時區。如果不設定，預設值為使用者的時區設定。

object (Action)

當使用者在 DateTimePicker 介面中按一下「Save」或「Clear」時，就會觸發這個事件。

{
  "title": string,
  "items": [
    {
      object (GridItem)
    }
  ],
  "borderStyle": {
    object (BorderStyle)
  },
  "columnCount": integer,
  "onClick": {
    object (OnClick)
  }
}

string

格線標題中顯示的文字。

object (GridItem)

格線檢視中的項目。

object (BorderStyle)

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

integer

格線中顯示的欄數。如果未指定這個欄位，則會使用預設值，且預設值會因格狀顯示位置 (對話方塊和隨播廣告) 而異。

object (OnClick)

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

{
  "id": string,
  "image": {
    object (ImageComponent)
  },
  "title": string,
  "subtitle": string,
  "layout": enum (GridItemLayout)
}

string

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

object (ImageComponent)

格線項目中顯示的圖片。

string

格線項目標題。

string

格線項目的子標題。

enum (GridItemLayout)

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

{
  "imageUri": string,
  "altText": string,
  "cropStyle": {
    object (ImageCropStyle)
  },
  "borderStyle": {
    object (BorderStyle)
  }
}

string

圖片網址。

string

圖片的無障礙標籤。

object (ImageCropStyle)

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

object (BorderStyle)

套用至圖片的邊框樣式。

{
  "type": enum (ImageCropType),
  "aspectRatio": number
}

enum (ImageCropType)

裁剪類型。

number

如果裁剪類型為 RECTANGLE_CUSTOM，要使用的長寬比。

以下範例說明如何套用 16:9 的長寬比：

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

{
  "type": enum (BorderType),
  "strokeColor": {
    object (Color)
  },
  "cornerRadius": integer
}

enum (BorderType)

邊框類型。

object (Color)

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

integer

框線的圓角半徑。

{
  "columnItems": [
    {
      object (Column)
    }
  ]
}

object (Column)

資料欄陣列。資訊卡或對話方塊中最多可加入 2 個欄。

{
  "horizontalSizeStyle": enum (HorizontalSizeStyle),
  "horizontalAlignment": enum (HorizontalAlignment),
  "verticalAlignment": enum (VerticalAlignment),
  "widgets": [
    {
      object (Widgets)
    }
  ]
}

enum (HorizontalSizeStyle)

說明資料欄如何填滿資訊卡寬度。

enum (HorizontalAlignment)

指定小工具是否對齊資料欄的左側、中間或中間。

enum (VerticalAlignment)

指定小工具是否與資料欄頂端、底部或中央對齊。

object (Widgets)

一欄內含小工具陣列。小工具會依照指定的順序顯示。

{

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "decoratedText": {
    object (DecoratedText)
  },
  "buttonList": {
    object (ButtonList)
  },
  "textInput": {
    object (TextInput)
  },
  "selectionInput": {
    object (SelectionInput)
  },
  "dateTimePicker": {
    object (DateTimePicker)
  }
  // End of list of possible types for union field data.
}

object (TextParagraph)

「TextParagraph」小工具。

object (Image)

「Image」小工具。

object (DecoratedText)

「DecoratedText」小工具。

object (ButtonList)

「ButtonList」小工具。

object (TextInput)

「TextInput」小工具。

object (SelectionInput)

「SelectionInput」小工具。

object (DateTimePicker)

「DateTimePicker」小工具。

{
  "actionLabel": string,
  "onClick": {
    object (OnClick)
  }
}

string

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

object (OnClick)

此操作項目的 onClick 動作。

{
  "primaryButton": {
    object (Button)
  },
  "secondaryButton": {
    object (Button)
  }
}

object (Button)

已修正頁尾的主要按鈕。按鈕必須是包含文字顏色和顏色的文字按鈕。

object (Button)

固定頁尾的次要按鈕。按鈕必須是包含文字顏色和顏色的文字按鈕。如果設定了 secondaryButton，您也必須設定 primaryButton。