Thẻ
Thẻ là một thành phần trên giao diện người dùng có thể chứa các tiện ích trên giao diện người dùng như văn bản và hình ảnh.
Biểu diễn dưới dạng JSON |
---|
{ "header": { object ( |
Trường | |
---|---|
header
|
Tiêu đề của thẻ. Tiêu đề thường chứa tiêu đề và hình ảnh. |
sections[]
|
Các phần được phân tách bằng dấu phân chia dòng. |
cardActions[]
|
Các hành động của thẻ này. |
name
|
Tên thẻ. |
CardHeader
Biểu diễn dưới dạng JSON |
---|
{
"title": string,
"subtitle": string,
"imageStyle": enum (
|
Trường | |
---|---|
title
|
Bạn phải chỉ định tiêu đề. Tiêu đề có chiều cao cố định: nếu cả tiêu đề và phụ đề đều được chỉ định thì mỗi tiêu đề sẽ chiếm một dòng. Nếu chỉ có tiêu đề được chỉ định thì tiêu đề sẽ bao gồm cả hai dòng. |
subtitle
|
Phụ đề của tiêu đề thẻ. |
imageStyle
|
Loại hình ảnh (ví dụ: đường viền vuông hoặc đường viền tròn). |
imageUrl
|
URL của hình ảnh trong tiêu đề thẻ. |
ImageStyle
Enum | |
---|---|
IMAGE_STYLE_UNSPECIFIED
|
|
IMAGE
|
Đường viền vuông. |
AVATAR
|
Đường viền tròn. |
Mục
Một phần chứa tập hợp các tiện ích được hiển thị (theo chiều dọc) theo thứ tự được chỉ định. Trên tất cả nền tảng, thẻ có chiều rộng cố định hẹp, vì vậy, hiện không cần thuộc tính bố cục (ví dụ: độ chính xác đơn).
Biểu diễn dưới dạng JSON |
---|
{
"header": string,
"widgets": [
{
object (
|
Trường | |
---|---|
header
|
Tiêu đề của phần. Có hỗ trợ định dạng văn bản. Để biết thêm thông tin về việc định dạng văn bản, hãy xem phần Định dạng văn bản trong các ứng dụng Google Chat và Định dạng văn bản trong Tiện ích bổ sung của Google Workspace. |
widgets[]
|
Phần phải chứa ít nhất một tiện ích. |
WidgetMarkup
Tiện ích là một thành phần trên giao diện người dùng trình bày văn bản và hình ảnh.
Biểu diễn dưới dạng JSON |
---|
{ "buttons": [ { object ( |
Trường | |
---|---|
buttons[]
|
Danh sách các nút. Các nút cũng là |
Trường hợp data . WidgetMarkup chỉ có thể có một trong các mục sau. Bạn có thể sử dụng nhiều trường WidgetMarkup để hiển thị nhiều mục hơn.
data chỉ có thể là một trong các trạng thái sau:
|
|
textParagraph
|
Hiển thị một đoạn văn bản trong tiện ích này. |
image
|
Hiển thị hình ảnh trong tiện ích này. |
keyValue
|
Hiển thị một mục khoá-giá trị trong tiện ích này. |
TextParagraph
Một đoạn văn bản. Có hỗ trợ định dạng văn bản. Để biết thêm thông tin về việc định dạng văn bản, hãy xem phần Định dạng văn bản trong các ứng dụng Google Chat và Định dạng văn bản trong Tiện ích bổ sung của Google Workspace.
Biểu diễn dưới dạng JSON |
---|
{ "text": string } |
Trường | |
---|---|
text
|
|
Bài đăng có hình ảnh
Hình ảnh được chỉ định bằng một URL và có thể có thao tác onclick
.
Biểu diễn dưới dạng JSON |
---|
{
"imageUrl": string,
"onClick": {
object (
|
Trường | |
---|---|
imageUrl
|
URL của hình ảnh. |
onClick
|
Hành động |
aspectRatio
|
Tỷ lệ cỡ ảnh của hình ảnh này (chiều rộng và chiều cao). Trường này cho phép bạn đặt trước chiều cao phù hợp cho hình ảnh trong khi chờ tải. Điều này không nhằm ghi đè tỷ lệ khung hình tích hợp sẵn của hình ảnh. Nếu bạn không đặt chính sách này, máy chủ sẽ điền thông tin bằng cách tìm nạp trước hình ảnh. |
OnClick
Thao tác onclick
(ví dụ: mở một đường liên kết).
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp
|
|
action
|
Thao tác biểu mẫu sẽ được kích hoạt bằng thao tác |
openLink
|
Thao tác |
FormAction
Hành động đối với biểu mẫu mô tả hành vi khi biểu mẫu được gửi. Ví dụ: bạn có thể gọi Apps Script để xử lý biểu mẫu.
Biểu diễn dưới dạng JSON |
---|
{
"actionMethodName": string,
"parameters": [
{
object (
|
Trường | |
---|---|
actionMethodName
|
Tên phương thức dùng để xác định phần nào trong biểu mẫu đã kích hoạt lượt gửi biểu mẫu. Thông tin này được lặp lại cho ứng dụng Chat trong sự kiện nhấp vào thẻ. Bạn có thể sử dụng cùng một tên phương thức cho một số phần tử kích hoạt một hành vi phổ biến. |
parameters[]
|
Danh sách thông số hành động. |
ActionParameter
Danh sách các tham số chuỗi cần cung cấp khi phương thức hành động được gọi. Ví dụ: xem xét 3 nút tạm ẩn: tạm hoãn ngay bây giờ, tạm hoãn một ngày, tạm ẩn vào tuần tới. Bạn có thể sử dụng action method = snooze()
để truyền loại tạm ẩn và thời gian tạm ẩn trong danh sách các tham số chuỗi.
Biểu diễn dưới dạng JSON |
---|
{ "key": string, "value": string } |
Trường | |
---|---|
key
|
Tên của thông số cho tập lệnh hành động. |
value
|
Giá trị của thông số. |
OpenLink
Một đường liên kết mở ra một cửa sổ mới.
Biểu diễn dưới dạng JSON |
---|
{ "url": string } |
Trường | |
---|---|
url
|
URL cần mở. |
KeyValue
Thành phần trên giao diện người dùng chứa khoá (nhãn) và giá trị (nội dung). Phần tử này cũng có thể chứa một số thao tác như nút onclick
.
Biểu diễn dưới dạng JSON |
---|
{ "topLabel": string, "content": string, "contentMultiline": boolean, "bottomLabel": string, "onClick": { object ( |
Trường | |
---|---|
topLabel
|
Văn bản của nhãn trên cùng. Có hỗ trợ định dạng văn bản. Để biết thêm thông tin về việc định dạng văn bản, hãy xem phần Định dạng văn bản trong các ứng dụng Google Chat và Định dạng văn bản trong Tiện ích bổ sung của Google Workspace. |
content
|
Văn bản của nội dung. Hệ thống luôn hỗ trợ định dạng văn bản và luôn bắt buộc phải có. Để biết thêm thông tin về việc định dạng văn bản, hãy xem phần Định dạng văn bản trong các ứng dụng Google Chat và Định dạng văn bản trong Tiện ích bổ sung của Google Workspace. |
contentMultiline
|
Nội dung có phải nhiều dòng hay không. |
bottomLabel
|
Văn bản của nhãn dưới cùng. Có hỗ trợ định dạng văn bản. Để biết thêm thông tin về việc định dạng văn bản, hãy xem phần Định dạng văn bản trong các ứng dụng Google Chat và Định dạng văn bản trong Tiện ích bổ sung của Google Workspace. |
onClick
|
Hành động |
Trường hợp icons . Bạn phải xác định ít nhất một trong các biểu tượng: top_label và bottom_label .
icons chỉ có thể là một trong các trạng thái sau:
|
|
icon
|
Một giá trị enum được thay thế bằng API Chat bằng hình ảnh biểu tượng tương ứng. |
iconUrl
|
Biểu tượng do URL chỉ định. |
Trường hợp control . Tiện ích điều khiển. Bạn có thể đặt button hoặc switch_widget , nhưng không thể đặt cả hai.
control chỉ có thể là một trong các trạng thái sau:
|
|
button
|
Một nút mà người dùng có thể nhấp vào để kích hoạt hành động. |
Biểu tượng
Bộ biểu tượng được hỗ trợ.
Enum | |
---|---|
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
|
Nút
Nút. Có thể là nút văn bản hoặc nút hình ảnh.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp
|
|
textButton
|
Một nút có văn bản và thao tác |
imageButton
|
Một nút có hình ảnh và thao tác |
TextButton
Một nút có văn bản và thao tác onclick
.
Biểu diễn dưới dạng JSON |
---|
{
"text": string,
"onClick": {
object (
|
Trường | |
---|---|
text
|
Văn bản của nút. |
onClick
|
Hành động |
ImageButton
Nút hình ảnh có thao tác onclick
.
Biểu diễn dưới dạng JSON |
---|
{ "onClick": { object ( |
Trường | |
---|---|
onClick
|
Hành động |
name
|
Tên của |
Trường hợp icons . Biểu tượng này có thể được chỉ định bằng Icon
enum hoặc một URL.
icons chỉ có thể là một trong các trạng thái sau:
|
|
icon
|
Biểu tượng do |
iconUrl
|
Biểu tượng do URL chỉ định. |
CardAction
Hành động đối với thẻ là một hành động được liên kết với thẻ. Đối với thẻ hoá đơn, thao tác điển hình sẽ là: xoá hoá đơn, gửi hoá đơn qua email hoặc mở hoá đơn trong trình duyệt.
Không được các ứng dụng Google Chat hỗ trợ.
Biểu diễn dưới dạng JSON |
---|
{
"actionLabel": string,
"onClick": {
object (
|
Trường | |
---|---|
actionLabel
|
Nhãn dùng để hiển thị trong mục trình đơn thao tác. |
onClick
|
Thao tác nhấp cho mục hành động này. |