Thiết kế các thành phần của thẻ hoặc hộp thoại

Trang này mô tả cách thiết kế và tạo các thành phần chính trên giao diện người dùng của thông báo thẻ trong Google Chat.

Thẻ hỗ trợ một bố cục xác định, các phần tử trên giao diện người dùng tương tác (chẳng hạn như các nút) và nội dung đa phương tiện như hình ảnh. Bạn có thể dùng các thẻ để trình bày thông tin, thu thập thông tin đầu vào hoặc đưa ra các bước tiếp theo cho người dùng thông qua thông điệp thẻ và hộp thoại.

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ẻ

Thẻ và hộp thoại thường có những thành phần sau:

  • CardHeader chứa tiêu đề thẻ của bạn.
  • Một hoặc nhiều tiện ích CardSection tạo thành phần chính của thẻ.
  • Tiện ích CardFixedFooter dành riêng cho hộp thoại.

Điều kiện tiên quyết

  • Một tài khoản Google Workspace có quyền truy cập vào Google Chat.
  • Một ứng dụng Chat đã phát hành. Để tạo một ứng dụng Chat, hãy làm theo hướng dẫn quickstart sau đây.

    • Thêm tiêu đề

    Tiện ích CardHeader đại diện cho tiêu đề của thẻ. Tiêu đề có thể bao gồm tiêu đề, phụ đề và hình đại diện cho thẻ của bạn.

    Bạn có thể bao gồm CardHeader cho thông báo thẻ và hộp thoại.

    Sau đây là ví dụ về một CardHeader:

    Xác định một phần của thẻ

    Tiện ích CardSection là vùng chứa cấp cao trong thẻ. Bạn sử dụng các phần thẻ để nhóm các tiện ích trong một thẻ. Đối với mỗi phần thẻ, bạn có thể thêm tiêu đề và một hoặc nhiều tiện ích.

    Bạn có thể bao gồm CardSection cho thông báo thẻ và hộp thoại.

    Sau đây là ví dụ về CardSection chứa hai tiện ích textParagraph:

    Tiện ích CardFixedFooter biểu thị chân trang của tin nhắn hộp thoại do ứng dụng Chat gửi. Chân trang có thể bao gồm một nút chính và một nút phụ.

    Tiện ích CardFixedFooter chỉ dùng được cho hộp thoại.

    Sau đây là ví dụ về tiện ích CardFixedFooter có 2 nút:

    Khắc phục sự cố

    Khi một ứng dụng hoặc thẻ Google Chat trả về lỗi, giao diện Chat sẽ hiển thị một thông báo cho biết "Đã xảy ra lỗi". hoặc "Không thể xử lý yêu cầu của bạn". Đôi khi, giao diện người dùng của Chat không hiển thị thông báo lỗi nào, nhưng ứng dụng hoặc thẻ trong Chat lại cho ra kết quả không mong muốn; ví dụ: thông báo thẻ có thể không xuất hiện.

    Mặc dù thông báo lỗi có thể không xuất hiện trong giao diện người dùng của Chat, nhưng chúng tôi cung cấp dữ liệu nhật ký và thông báo lỗi mô tả để giúp bạn khắc phục lỗi khi bật tính năng ghi nhật ký lỗi cho các ứng dụng trong Chat. Để được trợ giúp xem, gỡ lỗi và sửa lỗi, hãy xem bài viết Khắc phục sự cố và sửa lỗi Google Chat.