Định dạng tin nhắn

Google Chat cho phép bạn thêm định dạng cho tin nhắn, bao gồm:

Định dạng tin nhắn văn bản

Chat cho phép bạn thêm định dạng cơ bản vào tin nhắn văn bản (bao gồm chữ in đậm, in nghiêng và gạch ngang chữ) bằng cách sử dụng một tập hợp nhỏ cú pháp Markdown. Bạn định dạng văn bản trong tin nhắn văn bản khác với trong tin nhắn thẻ vì tin nhắn văn bản được định dạng theo cùng cú pháp mà người dùng Chat sử dụng. Để định dạng văn bản xuất hiện trong thẻ, hãy xem phần Định dạng thông báo trên thẻ.

Để định dạng tin nhắn văn bản, hãy sử dụng cú pháp sau:

Định dạng Biểu tượng Cú pháp mẫu Văn bản xuất hiện trong Google Chat
Đậm * *xin chào* xin chào
Nghiêng _ (dấu gạch dưới) _xin chào_ xin chào
Gạch ngang chữ ~ ~xin chào~ xin chào
Đơn cách ` (dấu ngoặc kép) "xin chào" hello
Khối đơn cách ` ` ` (ba dấu ngoặc kép) ```
Xin chào
Mọi người
```		 Hello
World
Danh sách có dấu đầu dòng * hoặc - (dấu gạch nối) theo sau là một dấu cách

* Đây là mục đầu tiên trong danh sách

* Đây là mục thứ hai trong danh sách
  • Đây là mục đầu tiên trong danh sách
  • Đây là mục thứ hai trong danh sách

Ví dụ: hãy xem xét JSON sau:

    {
      "text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
    }

Tin nhắn văn bản được định dạng này sẽ hiển thị những nội dung sau trong phòng Chat:

Ứng dụng Cymbal Pizza gửi một tin nhắn văn bản thông báo giao hàng đã đến.

Xem định dạng văn bản được gửi trong tin nhắn

Khi người dùng gửi một tin nhắn, phần nội dung dưới dạng văn bản thuần tuý của thông báo sẽ nằm trong trường text. Một số định dạng được áp dụng cho tin nhắn văn bản bằng cú pháp Markdown, nằm trong trường text. Định dạng bổ sung nằm trong trường formattedText chỉ có đầu ra, bao gồm:

  • Cú pháp Markdown bổ sung cho văn bản
  • Lượt đề cập của người dùng
  • Siêu liên kết tùy chỉnh
  • Biểu tượng cảm xúc tuỳ chỉnh

Ví dụ: hãy xem xét văn bản sau đây do người dùng gửi:

Tin nhắn đã nhận trong Chat có từ này

Nếu tin nhắn được định dạng bằng cách sử dụng trình đơn Format (Định dạng) trong giao diện người dùng Chat, thì trường text chỉ chứa văn bản, trong khi trường formattedText chứa nội dung đánh dấu, văn bản và siêu liên kết. Ví dụ sau đây hiển thị bản nháp của tin nhắn văn bản có một từ siêu liên kết, các mục trong danh sách và một từ được in đậm:

Tin nhắn nháp có từ này

Thư nhận được có định dạng sau:

    {
      "text": "I can meet there at:\nNoon\n3 pm\n5 pm\nWhat time works for you?",
      "formattedText": "I can meet <http://example.com|there> at:\n* Noon\n* 3 pm\n* 5 pm\nWhat time works for *you*?",
    }

Nếu bạn thêm một URL đường liên kết thuần tuý vào văn bản tin nhắn, chẳng hạn như http://www.example.com/, thì Google Chat sẽ dùng URL này làm văn bản liên kết và tự động chuyển văn bản đó đến URL được chỉ định.

Để cung cấp văn bản liên kết thay thế cho đường liên kết của bạn, hãy sử dụng cú pháp sau:

Cú pháp mẫu Văn bản xuất hiện trong Google Chat
<https://example.com|Example website>

Đường dẫn và văn bản liên kết là không bắt buộc, để <https://www.example.com/> và https://www.example.com/ tương đương với nhau.

Đề cập đến người dùng trong tin nhắn văn bản

Các ứng dụng nhắn tin có thể gửi tin nhắn văn bản có đề cập bằng @với một hoặc tất cả người dùng trong phòng Chat. Các ứng dụng nhắn tin không được đề cập đến người dùng trong không gian đang ở chế độ nhập hoặc bất kỳ người dùng nào chưa tham gia không gian.

Đề cập người dùng bằng @

Để đề cập đến một người dùng cụ thể bằng @, hãy thêm <users/{user}> vào tin nhắn văn bản, trong đó {user} là mã nhận dạng của người dùng đó. Ví dụ: hãy xem xét tin nhắn văn bản sau, trong đó 123456789012345678901 biểu thị mã nhận dạng của người dùng Mahan S.:

{
    "text": "A customer has reported an issue. Assigning ticket #942 to <users/123456789012345678901>."
}

Tin nhắn văn bản sẽ có dạng như sau:

Ứng dụng nhắn tin đề cập đến một người trong tin nhắn văn bản.

Bạn có thể chỉ định giá trị users/{user} theo những cách sau:

  • Nếu ứng dụng Google Chat của bạn đang phản hồi tin nhắn do người dùng gửi, thì bạn có thể sử dụng trường message.sender.name của sự kiện tương tác trên MESSAGE.

  • Nếu ứng dụng Google Chat đang tạo một tin nhắn văn bản không đồng bộ, bạn có thể chỉ định giá trị cho users/{user} theo những cách sau:

    • Sử dụng trường name của tài nguyên User của Google Chat, chẳng hạn như users/123456789012345678901.
    • Sử dụng địa chỉ email của người dùng làm email đại diện cho giá trị {user}. Ví dụ: nếu địa chỉ email là mahan@example.com, bạn có thể chỉ định người dùng là users/mahan@example.com. Để sử dụng email đại diện, ứng dụng Google Chat phải xác thực với tư cách là người dùng.

  • Nếu sử dụng API Mọi người, bạn cũng có thể sử dụng phương thức people.get để xác định mã nhận dạng người dùng.

đề cập tất cả người dùng bằng @

Để tạo tin nhắn văn bản nhắc đến mọi người trong không gian bằng @, hãy thay thế {user} bằng all. Ví dụ JSON sau đây đề cập đến tất cả người dùng trong một thông báo:

{
    "text": "Important message for <users/all>: Code freeze starts at midnight tonight!"
}

Định dạng thông báo bằng thẻ

Bên trong thẻ, hầu hết các trường văn bản đều hỗ trợ định dạng văn bản cơ bản bằng cách sử dụng một tập hợp con thẻ HTML nhỏ. Bạn định dạng văn bản trong tin nhắn thẻ khác với trong tin nhắn văn bản vì tin nhắn văn bản được định dạng theo cú pháp giống như người dùng Chat sử dụng. Để định dạng văn bản xuất hiện trong một tin nhắn văn bản, vui lòng xem phần Định dạng tin nhắn văn bản.

Sử dụng Trình tạo thẻ để thiết kế và xem trước thông báo trong thẻ JSON cho ứng dụng nhắn tin:

Mở Trình tạo thẻ

Các thẻ được hỗ trợ và mục đích của chúng được trình bày trong bảng sau:

Định dạng Ví dụ: Kết quả được hiển thị
Đậm "This is <b>bold</b>." Đây là chữ in đậm.
In nghiêng "This is <i>italics</i>." Đây là chữ in nghiêng.
Underline "This is <u>underline</u>." Đây là gạch chân.
Gạch ngang chữ "This is <s>strikethrough</s>." Đây là gạch ngang chữ.
Màu phông chữ "This is <font color=\"#FF0000\">red font</font>." Đây là phông chữ màu đỏ.
Đường siêu liên kết "This is a <a href=\"https://www.google.com\">hyperlink</a>." Đây là một siêu liên kết.
Thời gian "This is a time format: <time>2023-02-16 15:00</time>." Đây là định dạng thời gian: .
Dòng mới "This is the first line. <br> This is a new line." Đây là dòng đầu tiên.
Đây là một dòng mới.

Thêm biểu tượng tích hợp sẵn vào thẻ

Tiện ích DecoratedText và ButtonList hỗ trợ phần tử icon dùng để chỉ định một trong các biểu tượng tích hợp có trong Chat.

Bảng sau đây liệt kê các biểu tượng tích hợp sẵn dành cho thông báo bằng thẻ:

Máy bay BOOKMARK
BUS Ô TÔ
KHOÁ CONFIRMATION_NUMBER_ICON
MÔ TẢ Hàm rỗng
EMAIL EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
KHÁCH SẠN HOTEL_ROOM_TYPE
MỜI MAP_PIN
LÀ HỘI VIÊN MULTIPLE_PEOPLE
MỘT NGƯỜI SỐ ĐIỆN THOẠI
RESTAURANT_ICON SHOPPING_CART
SAO CỬA HÀNG
VÉ TRAIN
VIDEO_CAMERA VIDEO_PLAY

Sau đây là ví dụ về thẻ có biểu tượng email:

Thêm biểu tượng Google Material Design vào thẻ

Các tiện ích DecoratedText và ButtonList cho phép bạn sử dụng biểu tượng Google Material để có thể chọn trong số hơn 2500 lựa chọn biểu tượng và tuỳ chỉnh trọng số, màu nền và cấp của biểu tượng.

Sau đây là ví dụ về thẻ có biểu tượng Google Material:

Thêm biểu tượng tuỳ chỉnh vào thẻ

Các tiện ích DecoratedText và ButtonList cho phép bạn sử dụng các biểu tượng tích hợp sẵn hoặc xác định biểu tượng tuỳ chỉnh của riêng mình. Để thêm biểu tượng tuỳ chỉnh vào một thẻ, hãy thêm trường iconUrl và chỉ định URL tương ứng của biểu tượng.

Sau đây là ví dụ về một biểu tượng tuỳ chỉnh: