Memformat pesan

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

Memformat pesan teks

Chat memungkinkan Anda menambahkan format dasar ke pesan teks, termasuk tebal, miring, dan coret, dengan menggunakan {i>subset<i} kecil dari sintaks Markdown. Anda memformat teks secara berbeda dalam pesan teks dibandingkan dalam pesan kartu karena teks pesan diformat dengan sintaksis yang sama dengan Chat digunakan pengguna. 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) _hello_ halo
Coret ~ ~halo~ halo
Monospace ` (kutip tunggal terbalik) `halo` hello
Blok monospace ` ` ` (tiga tanda kutip terbalik) ```
Hello
World
```		 Hello
World
Daftar berbutir * atau - (tanda hubung) diikuti dengan spasi

* Ini adalah item pertama dalam daftar

* Ini adalah item kedua dalam daftar
  • Ini adalah item pertama dalam daftar
  • Ini adalah item kedua dalam daftar

Misalnya, pertimbangkan JSON berikut:

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

Pesan teks berformat ini menampilkan hal berikut dalam Chat alamat:

Aplikasi Cymbal Pizza mengirim pesan teks bahwa pengiriman sudah tiba.

Melihat pemformatan teks yang dikirim dalam pesan

Ketika pengguna mengirim pesan, isi teks polos dari pesan itu berada di Kolom text. Beberapa format yang diterapkan pada pesan teks menggunakan Markdown sintaksis ada di kolom text. Format tambahan ada di kolom formattedText khusus output, termasuk hal berikut:

  • Sintaksis Markdown tambahan 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 dengan menggunakan menu Format di UI Chat, kolom text hanya berisi teks, sedangkan kolom Kolom formattedText berisi markup, teks, dan hyperlink. Tujuan contoh berikut menunjukkan draf pesan teks dengan kata yang {i>hyperlink<i}, item dalam daftar, dan satu kata dicetak tebal:

Draf pesan berisi kata

Pesan diterima dalam format berikut:

    {
      "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*?",
    }

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

Untuk memberikan teks tautan alternatif untuk tautan Anda, gunakan sintaks berikut:

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

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

Menyebut pengguna dalam pesan teks

Aplikasi chat dapat kirim pesan teks yang @menyebut satu atau semua pengguna di ruang Chat. Aplikasi Chat tidak dapat menyebut pengguna dalam ruang penyimpanan yang berada dalam mode impor atau pengguna yang belum bergabung ke ruang.

Pengguna tertentu menggunakan @sebutan

Untuk @menyebut pengguna tertentu, tambahkan <users/{user}> ke pesan teks dengan {user} adalah ID pengguna. Misalnya, perhatikan teks berikut pesan dengan 123456789012345678901 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 menyebut seseorang dalam pesan teks.

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

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

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

    • Menggunakan kolom name di Google Chat Resource User, seperti users/123456789012345678901.
    • Gunakan alamat email pengguna sebagai alias untuk nilai {user}. Sebagai misalnya, jika alamat emailnya adalah mahan@example.com, Anda dapat menentukan pengguna sebagai users/mahan@example.com. Untuk menggunakan alias email, Aplikasi Google Chat harus melakukan autentikasi sebagai pengguna.

  • Jika Anda menggunakan People API, Anda juga dapat menggunakan Metode people.get untuk mengidentifikasi User-ID.

@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 {i>text field<i} mendukung pemformatan teks dasar dengan menggunakan subset tag HTML. Anda memformat teks dengan cara yang berbeda di pesan kartu dibandingkan dengan teks pesan karena pesan teks diformat dengan sintaks yang sama dengan Chat digunakan pengguna. Untuk memformat teks yang muncul di pesan teks, lihat Memformat pesan teks.

Gunakan Card Builder untuk mendesain dan melihat pratinjau pesan kartu JSON untuk aplikasi Chat:

Membuka Card Builder

Tag yang didukung dan tujuannya ditampilkan dalam tabel:

Format Contoh Hasil yang dirender
Tebal "This is <b>bold</b>." Teks ini tebal.
Miring "This is <i>italics</i>." Nama ini miring.
Garis bawah "This is <u>underline</u>." Ini adalah garis bawah.
Coret "This is <s>strikethrough</s>." Kolom 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

Tujuan DecoratedText dan ButtonList widget mendukung elemen icon digunakan untuk menentukan salah satu ikon bawaan yang tersedia di {i>Chat.<i}

Tabel berikut mencantumkan ikon bawaan yang tersedia untuk pesan kartu:

pesawat PANDUAN BUKU
BUS MOBIL
JAM CONFIRMATION_NUMBER_ICON
DESCRIPTION DOLAR
EMAIL EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
HOTEL HOTEL_ROOM_TYPE
INVITE MAP_PIN
LANGGANAN MULTIPLE_PEOPLE
ORANG TELEPON
RESTAURANT_ICON SHOPPING_CART
BINTANG TOKO
TIKET LATIHAN
VIDEO_CAMERA VIDEO_PLAY

Tujuan berikut adalah contoh kartu dengan ikon email:

Menambahkan ikon Desain Material Google ke kartu

Tujuan DecoratedText dan ButtonList memungkinkan Anda menggunakan ikon Google Material sehingga Anda dapat memilih dari lebih dari 2500+ opsi ikon dan menyesuaikan bobot, isian, dan nilai ikon.

Berikut adalah contoh kartu dengan ikon Material Google:

Menambahkan ikon khusus ke kartu

Tujuan DecoratedText dan ButtonList memungkinkan Anda menggunakan ikon bawaan, atau menentukan ikon khusus sendiri. Kepada tambahkan ikon khusus ke kartu, sertakan kolom iconUrl dan tentukan URL yang sesuai.

Berikut adalah contoh ikon khusus: