Memformat pesan

Google Chat memungkinkan Anda menambahkan pemformatan ke pesan, termasuk hal berikut:

Memformat pesan teks

Chat memungkinkan Anda menambahkan pemformatan dasar ke pesan teks, termasuk tebal, miring, dan coret, dengan menggunakan sebagian kecil sintaksis Markdown. Anda memformat teks secara berbeda di pesan teks dan di pesan kartu karena pesan teks diformat dengan sintaksis yang sama dengan yang digunakan pengguna Chat. Untuk memformat teks yang muncul di kartu, lihat Memformat pesan kartu.

Untuk memformat pesan teks, gunakan sintaksis berikut:

Format Simbol Contoh sintaksis Teks yang ditampilkan di Google Chat
Tebal * *halo* halo
Miring _ (garis bawah) _halo_ halo
Coret ~ ~halo~ halo
Monospace ` (petik tunggal terbalik) `halo` hello
Blok monospace ` ` ` (tiga tanda kutip terbalik) ```
Hello
World
```		 Hello
World

Misalnya, pertimbangkan JSON berikut:

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

Pesan teks berformat ini menampilkan hal berikut di ruang Chat:

Aplikasi Cymbal Pizza mengirimkan pesan teks bahwa pengiriman telah tiba.

Melihat pemformatan teks yang dikirim dalam pesan

Saat pengguna mengirim pesan, isi teks biasa pesan berada di kolom text. Beberapa format yang diterapkan pada pesan teks menggunakan sintaksis Markdown ada di kolom text. Pemformatan tambahan berada di kolom formattedText khusus output, termasuk:

  • Sintaksis markup untuk teks
  • Sebutan pengguna
  • Hyperlink kustom
  • Emoji kustom

Misalnya, perhatikan teks berikut yang dikirim oleh pengguna:

Pesan diterima di Chat yang berisi kata

Jika pesan diformat menggunakan menu Format di UI Chat, kolom text hanya akan berisi teks, sedangkan kolom formattedText berisi markup, teks, dan hyperlink. Contoh berikut menunjukkan draf pesan teks dengan kata hyperlink dan kata lain dicetak tebal:

Kirim pesan dengan kata

Pesan diterima dalam format berikut:

    {
      "text": "Be there at noon!",
      "formattedText": "Be <http://example.com|there> at *noon*",
    }

Jika Anda menyertakan URL link biasa dalam teks pesan, seperti http://www.example.com/, Google Chat akan menggunakannya sebagai teks link dan secara otomatis menautkan teks tersebut ke URL yang ditentukan.

Untuk memberikan teks link alternatif bagi link Anda, gunakan sintaksis berikut:

Contoh sintaksis Teks yang ditampilkan di Google Chat
<https://example.com|Example website>

Teks pipa dan link bersifat opsional, sehingga <https://www.example.com/> dan https://www.example.com/ setara.

Menyebutkan pengguna dalam pesan teks

Aplikasi Chat dapat mengirim pesan teks yang @menyebut satu atau semua pengguna di ruang Chat. Aplikasi Chat tidak dapat menyebutkan pengguna di ruang yang berada dalam mode impor.

@menyebut pengguna tertentu

Untuk @menyebut pengguna tertentu, tambahkan <users/{user}> ke pesan teks dengan {user} sebagai ID pengguna. Misalnya, pertimbangkan pesan teks berikut dengan 123456789012345678901 yang mewakili ID untuk pengguna Mahan S.:

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

Pesan teks akan ditampilkan sebagai berikut:

Aplikasi Chat menyebutkan seseorang dalam pesan teks.

Anda dapat menentukan nilai users/{user} dengan cara berikut:

  • Jika aplikasi Google Chat Anda merespons pesan yang dikirim oleh pengguna, Anda dapat menggunakan kolom message.sender.name dari peristiwa interaksi MESSAGE.

  • Jika aplikasi Google Chat Anda membuat pesan teks asinkron, Anda dapat menentukan nilai untuk users/{user} dengan cara berikut:

    • Gunakan kolom name resource User Google Chat, seperti users/123456789012345678901.
    • Gunakan alamat email pengguna sebagai alias untuk nilai {user}. Misalnya, jika alamat email adalah mahan@example.com, Anda dapat menentukan pengguna sebagai users/mahan@example.com. Untuk menggunakan alias email, aplikasi Google Chat Anda harus melakukan autentikasi sebagai pengguna.

  • Jika menggunakan People API, Anda juga dapat menggunakan metode people.get untuk mengidentifikasi ID pengguna.

@menyebut semua pengguna

Untuk membuat pesan teks yang @menyebut semua orang dalam ruang, ganti {user} dengan all. Contoh JSON berikut menyebutkan semua pengguna dalam pesan:

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

Memformat pesan kartu

Di dalam kartu, sebagian besar kolom teks mendukung pemformatan teks dasar dengan menggunakan sebagian kecil tag HTML. Anda memformat teks secara berbeda di pesan kartu dan pesan teks, karena pesan teks diformat dengan sintaksis yang sama dengan yang digunakan pengguna Chat. Untuk memformat teks yang muncul dalam pesan teks, lihat Memformat pesan teks.

Tag yang didukung dan tujuannya ditampilkan dalam tabel berikut:

Format Contoh Hasil yang dirender
Tebal "This is <b>bold</b>." Nama ini tebal.
Miring "This is <i>italics</i>." Namanya miring.
Garis bawah "This is <u>underline</u>." Ini adalah garis bawah.
Coret "This is <s>strikethrough</s>." Bagian ini dicoret.
Warna font "This is <font color=\"#FF0000\">red font</font>." Ini adalah font merah.
Hyperlink "This is a <a href=\"https://www.google.com\">hyperlink</a>." Ini adalah hyperlink.
Waktu "This is a time format: <time>2023-02-16 15:00</time>." Ini adalah format waktu: .
Baris baru "This is the first line. <br> This is a new line. inci Ini adalah baris pertama.
Ini adalah baris baru.

Menambahkan ikon bawaan ke kartu

Widget DecoratedText dan ButtonList mendukung elemen icon yang digunakan untuk menentukan salah satu ikon bawaan yang tersedia di Chat.

Tabel berikut mencantumkan ikon bawaan yang tersedia untuk pesan kartu:

pesawat BOOKMARK
BUS MOBIL
JAM CONFIRMATION_NUMBER_ICON
DESCRIPTION DOLLAR
EMAIL EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
HOTEL HOTEL_ROOM_TYPE
UNDANG MAP_PIN
LANGGANAN MULTIPLE_PEOPLE
ORANG TELEPON
RESTAURANT_ICON SHOPPING_CART
BINTANG TOKO
TIKET TRAIN
VIDEO_CAMERA VIDEO_PLAY

Berikut adalah contoh kartu dengan ikon email:

Menambahkan ikon khusus ke kartu

Widget DecoratedText dan ButtonList memungkinkan Anda menggunakan ikon bawaan, atau menentukan ikon kustom Anda sendiri. Untuk menentukan ikon khusus, gunakan elemen iconUrl seperti yang ditunjukkan pada contoh berikut: