Tổng quan về tin nhắn trong Google Chat

Trang này giải thích sự khác biệt giữa tin nhắn văn bản và tin nhắn dạng thẻ.

Khi ứng dụng Chat gửi tin nhắn văn bản để truyền đạt thông tin cơ bản, tin nhắn sẽ xuất hiện cùng dòng, giống như cách mọi người trong Google Chat viết tin nhắn. Để tạo tin nhắn chứa nhiều nội dung hơn văn bản hoặc để tạo tin nhắn mà người dùng có thể tương tác, ứng dụng Chat có thể sử dụng thẻ. Ứng dụng trò chuyện cũng có thể thêm thẻ vào tin nhắn văn bản. Để nhắc người dùng hoàn tất các quy trình nhiều bước, chẳng hạn như hoàn tất một biểu mẫu, ứng dụng Chat cũng có thể tạo các thẻ mở trong một cửa sổ mới dưới dạng hộp thoại.

Phân tích một tin nhắn văn bản

Trong API Google Chat, tin nhắn được biểu thị dưới dạng đối tượng JSON. Trong một thông báo, tin nhắn văn bản được biểu thị dưới dạng đối tượng text.

Trong ví dụ sau, ứng dụng Chat tạo một tin nhắn văn bản trong không gian cho một nhóm nhà phát triển phần mềm về việc sắp có lệnh ngừng thay đổi mã:

{
  "text": "Attention <users/all>: Code freeze starts at `11:59 am` Pacific Standard Time! If you need a little more time, type `/moreTime` and I'll push the code freeze back one hour."
}

JSON trả về thông báo sau:

Ví dụ về tin nhắn văn bản trong Google Chat thông báo về việc ngừng cập nhật mã.

Phân tích thành phần của thông báo thẻ

Trong API Google Chat, tin nhắn được biểu thị dưới dạng đối tượng JSON. Trong một thông báo, thẻ được biểu thị dưới dạng một mảng cardsV2 và bao gồm các phần sau:

  • Một hoặc nhiều đối tượng CardWithId.
  • cardId, dùng để xác định thẻ và phạm vi trong một thông báo nhất định. (Các thẻ trong các thông báo khác nhau có thể có cùng một mã nhận dạng.)

  • Đối tượng card bao gồm:

    • Đối tượng header chỉ định các thông tin như tiêu đề, phụ đề và hình ảnh theo kiểu hình đại diện.
    • Một hoặc nhiều đối tượng section, trong đó mỗi đối tượng chứa ít nhất một tiện ích.
    • Một hoặc nhiều đối tượng widget. Mỗi tiện ích là một đối tượng tổng hợp có thể đại diện cho văn bản, hình ảnh, các nút và các loại đối tượng khác.

Ví dụ: thông báo thẻ sau đây chứa các đối tượng header, section và widget:

Ứng dụng Chat chạy cuộc thăm dò ý kiến trong một không gian Chat bằng tin nhắn thẻ

Mã sau đây thể hiện JSON của thông báo thẻ:

JSON

{
  "cardsV2": [
    {
      "cardId": "unique-card-id",
      "card": {
        "header": {
          "title": "Sasha",
          "subtitle": "Software Engineer",
          "imageUrl": "https://developers.google.com/chat/images/quickstart-app-avatar.png",
          "imageType": "CIRCLE",
          "imageAltText": "Avatar for Sasha"
        },
        "sections": [
          {
            "header": "Contact Info",
            "collapsible": true,
            "uncollapsibleWidgetsCount": 1,
            "widgets": [
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "EMAIL"
                  },
                  "text": "sasha@example.com"
                }
              },
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "PERSON"
                  },
                  "text": "<font color=\"#80e27e\">Online</font>"
                }
              },
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "PHONE"
                  },
                  "text": "+1 (555) 555-1234"
                }
              },
              {
                "buttonList": {
                  "buttons": [
                    {
                      "text": "Share",
                      "onClick": {
                        "openLink": {
                          "url": "https://example.com/share"
                        }
                      }
                    },
                    {
                      "text": "Edit",
                      "onClick": {
                        "action": {
                          "function": "goToView",
                          "parameters": [
                            {
                              "key": "viewType",
                              "value": "EDIT"
                            }
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

Sử dụng Trình tạo thẻ để thiết kế và xem trước giao diện người dùng cũng như tính năng nhắn tin cho ứng dụng Chat:

Mở Trình tạo thẻ