Định dạng tin nhắn

Trang này giải thích cách các ứng dụng Google Chat có thể định dạng văn bản để gửi tin nhắn chứa bất kỳ thông tin nào sau đây:

• Văn bản đa dạng thức có chứa siêu liên kết hoặc lượt đề cập bằng @một hoặc tất cả người dùng trong một Phòng Chat.
• Văn bản xuất hiện trong giao diện thẻ, bao gồm dạng đoạn văn bản hoặc Văn bản giao diện người dùng xuất hiện cùng với một biểu tượng, chẳng hạn như một nút.

Đị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 in đậm, in nghiêng và gạch ngang chữ bằng cách sử dụng một tập hợp con 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 tin nhắn thẻ vì văn bản tin nhắn được định dạng bằng cú pháp giống như trong Chat mà người dùng sử dụng.

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

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ị các nội dung sau trong một ứng dụng Chat dấu cách:

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

Khi người dùng gửi thư, nội dung văn bản thuần tuý của thư 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 Markdown trong trường text. Định dạng bổ sung nằm trong trường formattedText chỉ có đầu ra, bao gồm các thông tin sau:

• 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 tuỳ 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 một người dùng gửi:

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

Thư được nhận theo đị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 đưa URL của đường liên kết thuần tuý vào văn bản thông báo, chẳng hạn như http://www.example.com/, Google Chat sử dụng địa chỉ này làm văn bản liên kết và tự động tạo siêu liên kết giữa 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:

Dấu sổ thẳng 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/ là tương đương.

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

Ứng dụng trong Chat có thể gửi tin nhắn văn bản đề cập đến một hoặc tất cả người dùng trong phòng Chat bằng @. Ứng dụng trong Chat không thể đề 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 đến người dùng cụ thể 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 kèm theo {user} là mã nhận dạng của người dùng. Ví dụ: hãy xem xét nội dung sau thông báo trong đó 123456789012345678901 đại diện cho 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 xuất hiện như sau:

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

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

• Nếu ứng dụng Google Chat của bạn đ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 các cách sau:

  • Sử dụng trường name của Google Chat Tài nguyên User, 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 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 user ID đó.

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

Để tạo tin nhắn văn bản đề cập đến mọi người bằng @trong một không gian, hãy thay thế {user} cùng với 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 văn bản xuất hiện trong thẻ

Bên trong các 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 mẫu một tập hợp con các thẻ HTML. Bạn định dạng văn bản trong thông báo thẻ khác với định dạng văn bản vì tin nhắn văn bản được định dạng với cùng một cú pháp Người dùng Chat sử dụng.

Sử dụng Trình tạo thẻ để thiết kế và xem trước thông báo cũng như giao diện người dùng của các ứng dụng trong Chat:

Định dạng văn bản của đoạn

Dưới đây là các thẻ được hỗ trợ và mục đích của chúng bảng:

Thêm biểu tượng vào văn bản

Để hiển thị các biểu tượng cùng với văn bản trong thẻ, bạn có thể sử dụng DecoratedText và ButtonList các tiện ích khác nhau.

Các phần sau giải thích cách sử dụng các biểu tượng tích hợp sẵn, Google Material hoặc biểu tượng tuỳ chỉnh trong văn bản hoặc nút được trang trí.

Sử dụng các biểu tượng của Chat

Cách sử dụng các biểu tượng tích hợp sẵn trong Chat: chỉ định một trong các thông tin sau:

Bảng sau đây liệt kê các biểu tượng tích hợp sẵn cho tin nhắn thẻ:

Chiến lược phát hành đĩa đơn sau đây là ví dụ về thẻ có biểu tượng email:

Sử dụng biểu tượng Google Material

Bạn có thể dùng biểu tượng Google Material để chọn trong số hơn 2500 tuỳ chọn biểu tượng và tuỳ chỉnh trọng số, tô màu nền và điểm của các biểu tượng.

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

Sử dụng biểu tượng tuỳ chỉnh

Để thêm biểu tượng tuỳ chỉnh, hãy thêm trường iconUrl và chỉ định biểu tượng URL tương ứng.

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