Trang này giải thích cách tạo trang chủ cho Ứng dụng Google Chat. Trang chủ ứng dụng là giao diện thẻ có thể tuỳ chỉnh mà ứng dụng Chat gửi cho người dùng khi họ mở một ứng dụng nhắn tin bằng ứng dụng Chat.
Ví dụ: bạn có thể định cấu hình thông báo trong thẻ trên trang chủ của ứng dụng để bao gồm các mẹo tương tác với Ứng dụng Chat đang dùng lệnh dấu gạch chéo. Đối với người dùng cuối, trang chủ ứng dụng là chỉ có trong tin nhắn trực tiếp của ứng dụng Chat nếu nhà phát triển ứng dụng bật tính năng này.
Sử dụng Trình tạo thẻ để thiết kế và xem trước thông báo trên thẻ JSON cho các ứng dụng trong Chat:
Mở Trình tạo thẻĐiều kiện tiên quyết
Python
Một ứng dụng Google Chat đã bật các tính năng tương tác. Để tạo một ứng dụng Chat tương tác bằng dịch vụ HTTP, hãy hoàn thành phần bắt đầu nhanh này.
Apps Script
Một ứng dụng Google Chat đã bật các tính năng tương tác. Để tạo một ứng dụng Chat tương tác trong Apps Script, hãy hoàn thành phần bắt đầu nhanh này.
Node.js
Một ứng dụng Google Chat đã bật các tính năng tương tác. Để tạo một ứng dụng Chat tương tác bằng dịch vụ HTTP, hãy hoàn thành phần bắt đầu nhanh này.
Java
Một ứng dụng Google Chat đã bật các tính năng tương tác. Để tạo một ứng dụng Chat tương tác bằng dịch vụ HTTP, hãy hoàn thành phần bắt đầu nhanh này.
Định cấu hình API Chat
Để hỗ trợ trang chủ ứng dụng, bạn phải cập nhật cấu hình API Chat trong bảng điều khiển Google Cloud.
Python
Trong bảng điều khiển Google Cloud, hãy chuyển đến Trình đơn > Sản phẩm khác > Google Workspace > Thư viện sản phẩm > API Google Chat.
Nhấp vào Manage (Quản lý), rồi nhấp vào thẻ Configuration (Cấu hình).
Chọn hộp đánh dấu Support App Home (Hỗ trợ trang chủ ứng dụng).
Trong trường URL của trang chủ ứng dụng, hãy thêm URL. Giá trị này thường giống nhau URL dưới dạng URL ứng dụng. URL này được gọi cho Sự kiện
APP_HOME
.Nhấp vào Lưu.
Apps Script
Trong bảng điều khiển Google Cloud, hãy chuyển đến Trình đơn > Sản phẩm khác > Google Workspace > Thư viện sản phẩm > API Google Chat.
Nhấp vào Manage (Quản lý), rồi nhấp vào thẻ Configuration (Cấu hình).
Chọn hộp đánh dấu Support App Home (Hỗ trợ trang chủ ứng dụng).
Nhấp vào Lưu.
Node.js
Trong bảng điều khiển Google Cloud, hãy chuyển đến Trình đơn > Sản phẩm khác > Google Workspace > Thư viện sản phẩm > API Google Chat.
Nhấp vào Manage (Quản lý), rồi nhấp vào thẻ Configuration (Cấu hình).
Chọn hộp đánh dấu Support App Home (Hỗ trợ trang chủ ứng dụng).
Trong trường URL của trang chủ ứng dụng, hãy thêm URL. Giá trị này thường giống nhau URL dưới dạng URL ứng dụng. URL này được gọi cho Sự kiện
APP_HOME
.Nhấp vào Lưu.
Java
Trong bảng điều khiển Google Cloud, hãy chuyển đến Trình đơn > Sản phẩm khác > Google Workspace > Thư viện sản phẩm > API Google Chat.
Nhấp vào Manage (Quản lý), rồi nhấp vào thẻ Configuration (Cấu hình).
Chọn hộp đánh dấu Support App Home (Hỗ trợ trang chủ ứng dụng).
Trong trường URL của trang chủ ứng dụng, hãy thêm URL. Giá trị này thường giống nhau URL dưới dạng URL ứng dụng. URL này được gọi cho Sự kiện
APP_HOME
.Nhấp vào Lưu.
Tạo trang chủ ứng dụng
Thẻ màn hình chính của ứng dụng được kích hoạt khi người dùng mở một tin nhắn trực tiếp từ ứng dụng Chat và ứng dụng này có thể được cập nhật dưới dạng phản hồi của một sự kiện tương tác như nhấp vào nút, gửi biểu mẫu hoặc đóng hộp thoại.
Trong ví dụ sau, ứng dụng Chat hiển thị thẻ màn hình chính của ứng dụng ban đầu cho thấy thời gian tạo thẻ và nút. Khi người dùng nhấp vào nút đó, ứng dụng Chat sẽ trả về một thẻ đã cập nhật cho thấy thời gian tạo thẻ mới.
Tạo thẻ ban đầu cho trang chủ ứng dụng
Để tạo trang chủ ứng dụng, ứng dụng Chat phải xử lý
APP_HOME
sự kiện tương tác và trả về một bản sao của
RenderActions
với thao tác điều hướng pushCard
.
Python
Apps Script
Triển khai hàm onAppHome
được gọi sau tất cả các sự kiện APP_HOME
:
Ví dụ này gửi thông báo thẻ bằng cách quay lại tệp JSON của thẻ. Bạn cũng có thể sử dụng Dịch vụ thẻ Apps Script.
Node.js
Java
Cập nhật thẻ trên màn hình chính của ứng dụng
Nếu thẻ trang chủ ban đầu của ứng dụng chứa các tiện ích tương tác, chẳng hạn như nút
hoặc lựa chọn đầu vào, ứng dụng Chat phải xử lý
các sự kiện tương tác có liên quan bằng cách trả về một bản sao của
RenderActions
bằng cách điều hướng updateCard
. Để tìm hiểu thêm về cách xử lý quảng cáo tương tác
tiện ích, xem
Xử lý thông tin do người dùng nhập.
Python
Apps Script
Ví dụ này gửi thông báo thẻ bằng cách quay lại tệp JSON của thẻ. Bạn cũng có thể sử dụng Dịch vụ thẻ Apps Script.
Node.js
Java
Các điểm hạn chế
Nhìn chung,
navigation
là
không dùng được cho ứng dụng nhắn tin. Bạn không thể trả về một chồng thẻ.
Chỉ pushCard
(cho câu trả lời ban đầu) và updateCard
(cho thông tin cập nhật)
dành cho ứng dụng Chat.
Chủ đề có liên quan
- Xem các mẫu ứng dụng trong Chat dùng trang chủ của ứng dụng.
Để mở hộp thoại, hãy sử dụng tương tác
OPEN_DIALOG
. Để biết thêm thông tin, xem Mở hộp thoại để phản hồi thẻ trên trang chủ của ứng dụng.Để đóng hộp thoại, hãy sử dụng hoạt động tương tác
CLOSE_DIALOG
để đóng hộp thoại rồi quay lại thẻ trên màn hình chính của ứng dụng hoặc dùngCLOSE_DIALOG_EXECUTE
để đóng hộp thoại và làm mới thẻ trên trang chủ của ứng dụng. Để thông tin khác, xem Phản hồi hộp thoại cho thẻ trên màn hình chính của ứng dụng.Để biết ví dụ về cách sử dụng trang chủ ứng dụng, hãy xem ứng dụng Chat quản lý vấn đề trong lớp học lập trình Tạo ứng dụng cho Google Chat bằng Gemini.