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 đường phân cách. |
card
|
Thao tác 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ụ đề đượ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ẽ chiếm cả hai dòng. |
subtitle
|
Phụ đề của tiêu đề thẻ. |
image
|
Loại hình ảnh (ví dụ: đường viền vuông hoặc đường viền tròn). |
image
|
URL của hình ảnh trong tiêu đề thẻ. |
ImageStyle
Enum | |
---|---|
IMAGE_STYLE_UNSPECIFIED
|
|
IMAGE
|
Đường viền hình vuông. |
AVATAR
|
Đường viền hình tròn. |
Phần
Phần chứa một 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ả các nền tảng, thẻ có chiều rộng cố định hẹp, vì vậy, hiện không cần đến các thuộc tính bố cục (ví dụ: float).
Biểu diễn dưới dạng JSON |
---|
{
"header": string,
"widgets": [
{
object ( |
Trường | |
---|---|
header
|
Tiêu đề của phần. Hỗ trợ văn bản được định dạng. Để 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 của Google Chat và Định dạng văn bản trong Tiện ích bổ sung cho Google Workspace. |
widgets[]
|
Một 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 hiển thị 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 kết 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ị thêm các mục.
data chỉ có thể là một trong những giá trị sau:
|
|
text
|
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. |
key
|
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. Hỗ trợ văn bản được định dạng. Để biết thêm thông tin về cách định dạng văn bản, hãy xem bài viết Định dạng văn bản trong ứ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
|
|
Hình ảnh
Hình ảnh do một URL chỉ định và có thể có thao tác onclick
.
Biểu diễn dưới dạng JSON |
---|
{
"imageUrl": string,
"onClick": {
object ( |
Trường | |
---|---|
image
|
URL của hình ảnh. |
on
|
Thao tác |
aspect
|
Tỷ lệ khung hì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ờ hình ảnh tải. Tỷ lệ khung hình này không được 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 giá trị bằng cách tìm nạp trước hình ảnh. |
OnClick
Một 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 kết hợp
|
|
action
|
Hành động của biểu mẫu sẽ được kích hoạt bằng hành động |
open
|
Thao tác
|
FormAction
Hành động trong 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 | |
---|---|
action
|
Tên phương thức được dùng để xác định phần nào của biểu mẫu đã kích hoạt việc gửi biểu mẫu. Thông tin này được phản hồi 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ụ: hãy 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 hoãn vào tuần tiếp theo. Bạn có thể sử dụng action method = snooze()
, truyền loại lệnh tạm ẩn và thời gian tạm ẩn vào danh sách 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
Đườ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
Một thành phần trên giao diện người dùng chứa một khoá (nhãn) và một 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 | |
---|---|
top
|
Văn bản của nhãn trên cùng. Hỗ trợ văn bản được định dạng. Để biết thêm thông tin về cách định dạng văn bản, hãy xem bài viết Định dạng văn bản trong ứ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. Văn bản được định dạng được hỗ trợ và luôn bắt buộ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 của Google Chat và Định dạng văn bản trong Tiện ích bổ sung cho Google Workspace. |
content
|
Nội dung phải có nhiều dòng hay không. |
bottom
|
Văn bản của nhãn dưới cùng. Hỗ trợ văn bản được định dạng. Để 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 của Google Chat và Định dạng văn bản trong Tiện ích bổ sung cho Google Workspace. |
on
|
Hành động |
Trường hợp hợp nhất
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 có thể là một trong những trạng thái sau đây:
|
|
icon
|
Giá trị enum được Chat API thay thế bằng hình ảnh biểu tượng tương ứng. |
icon
|
Biểu tượng do URL chỉ định. |
Trường hợp hợp nhất
control . Một tiện ích điều khiển. Bạn có thể đặt button hoặc switch_widget , nhưng không được đặt cả hai.
control chỉ được có thể là một trong những trạng thái sau đây:
|
|
button
|
Một nút có thể nhấp vào để kích hoạt một hành động. |
Biểu tượng
Tập hợp các 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
Mộ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 hợp nhất
|
|
text
|
Một nút có văn bản và hành động |
image
|
Một nút có hình ảnh và hành động |
TextButton
Một nút có văn bản và hành động 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. |
on
|
Thao tác |
ImageButton
Một nút hình ảnh có thao tác onclick
.
Biểu diễn dưới dạng JSON |
---|
{ "onClick": { object ( |
Trường | |
---|---|
on
|
Hành động |
name
|
Tên của |
Trường kết hợp icons . Bạn có thể chỉ định biểu tượng này bằng một Icon
enum hoặc một URL.
icons chỉ có thể là một trong những giá trị sau:
|
|
icon
|
Biểu tượng do |
icon
|
Biểu tượng được chỉ định bằng một URL. |
CardAction
Hành động đối với thẻ là hành động liên quan đến thẻ. Đối với thẻ hoá đơn, thao tác thông thường sẽ là: xoá hoá đơn, gửi hoá đơn qua email hoặc mở hoá đơn trong trình duyệt.
Ứng dụng Google Chat không hỗ trợ tính năng này.
Biểu diễn dưới dạng JSON |
---|
{
"actionLabel": string,
"onClick": {
object ( |
Trường | |
---|---|
action
|
Nhãn này từng xuất hiện trong mục trình đơn thao tác. |
on
|
Thao tác onclick cho mục hành động này. |