Google Chat cho phép bạn thêm định dạng cho tin nhắn, bao gồm:
- Các định dạng văn bản cơ bản, chẳng hạn như in đậm, in nghiêng và gạch ngang chữ trong tin nhắn văn bản và thông báo thẻ.
- Văn bản được liên kết.
- đề cập một hoặc tất cả người dùng bằng@ trong phòng Chat.
- Chỉ thêm biểu tượng tích hợp và biểu tượng tuỳ chỉnh trong thông báo thẻ.
Đị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~ | |
Đơ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 |
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 |
|
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:
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:
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:
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*?",
}
Định dạng đường liên kết
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:
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ênMESSAGE
. 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ênUser
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.
- Sử dụng trườ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à |
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 | ||
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: