Google Chat memungkinkan Anda menambahkan pemformatan ke pesan, termasuk yang berikut:
- Pemformatan teks dasar, seperti tebal, miring, dan coret, dalam pesan teks dan pesan kartu.
- Teks yang ditautkan.
- @menyebut satu atau semua pengguna di ruang Chat.
- Tambahkan ikon bawaan dan kustom hanya dalam pesan kartu.
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 dalam 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~ | |
Monospace | ` (petik tunggal terbalik) | `halo` | hello |
Blok monospace | ` ` ` (tiga tanda kutip terbalik) | ``` Halo Dunia ``` |
Hello |
Daftar berbutir | * atau - (tanda hubung) diikuti dengan spasi | * 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 ruang Chat:
Melihat pemformatan teks yang dikirim dalam pesan
Saat pengguna mengirim pesan, isi teks biasa pesan tersebut berada di kolom text
. Beberapa format yang diterapkan ke pesan teks menggunakan sintaksis
Markdown ada di kolom text
. Format tambahan ada pada kolom
formattedText
khusus output, termasuk kolom berikut:
- Sintaks Markdown tambahan untuk teks
- Sebutan pengguna
- Hyperlink kustom
- Emoji kustom
Misalnya, perhatikan teks berikut yang dikirim oleh pengguna:
Jika pesan diformat menggunakan menu Format di
UI Chat, kolom text
hanya berisi teks, sedangkan
kolom formattedText
berisi markup, teks, dan hyperlink. Contoh berikut menampilkan draf pesan teks dengan kata yang diberi hyperlink, item dalam daftar, dan satu kata dicetak tebal:
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*?",
}
Memformat link
Jika Anda menyertakan URL link biasa dalam teks pesan, seperti http://www.example.com/
, Google Chat akan menggunakannya sebagai teks link dan secara otomatis akan membuat hyperlink ke teks tersebut ke URL yang ditentukan.
Untuk memberikan teks link alternatif bagi link Anda, gunakan sintaks 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.
Menyebut pengguna dalam pesan teks
Aplikasi Chat dapat mengirim pesan teks yang dengan @menyebut satu atau semua pengguna dalam ruang Chat. Aplikasi chat tidak dapat menyebut pengguna di ruang yang berada dalam mode impor atau pengguna yang belum bergabung ke ruang.
@menyebut pengguna tertentu
Untuk @menyebut pengguna tertentu, tambahkan <users/{user}>
ke pesan teks dengan
{user}
sebagai ID pengguna tersebut. Misalnya, perhatikan pesan teks berikut 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:
Anda dapat menentukan nilai users/{user}
dengan cara berikut:
- Jika aplikasi Google Chat merespons pesan yang dikirim oleh
pengguna, Anda dapat menggunakan kolom
message.sender.name
dari peristiwa interaksiMESSAGE
. Jika aplikasi Google Chat membuat pesan teks asinkron, Anda dapat menentukan nilai untuk
users/{user}
dengan cara berikut:- Gunakan kolom
name
dari resourceUser
Google Chat, sepertiusers/123456789012345678901
. - Gunakan alamat email pengguna sebagai alias untuk nilai
{user}
. Misalnya, jika alamat email adalahmahan@example.com
, Anda dapat menentukan pengguna sebagaiusers/mahan@example.com
. Untuk menggunakan alias email, aplikasi Google Chat Anda harus melakukan autentikasi sebagai pengguna.
- Gunakan kolom
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 sekumpulan 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.
Gunakan Card Builder untuk mendesain dan melihat pratinjau pesan kartu JSON untuk aplikasi Chat:
Buka Pembuat KartuTag yang didukung dan tujuannya ditunjukkan dalam tabel berikut:
Format | Contoh | Hasil yang dirender |
---|---|---|
Tebal | "This is <b>bold</b>." |
Teks ini tebal. |
Miring | "This is <i>italics</i>." |
Ini adalah huruf miring. |
Garis bawah | "This is <u>underline</u>." |
Ini adalah garis bawah. |
Coret | "This is <s>strikethrough</s>." |
Bagian ini |
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 | DOLAR | ||
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 Desain Material Google ke kartu
Widget
DecoratedText
dan
ButtonList
memungkinkan Anda menggunakan ikon Material Google
sehingga Anda dapat memilih lebih dari 2.500 opsi ikon serta menyesuaikan
bobot, isian, dan tingkatan ikon.
Berikut adalah contoh kartu dengan ikon Material Google:
Menambahkan ikon khusus ke kartu
Widget
DecoratedText
dan
ButtonList
memungkinkan Anda menggunakan ikon bawaan, atau menentukan ikon kustom Anda sendiri. Untuk menambahkan ikon khusus ke kartu, sertakan kolom iconUrl
dan tentukan URL yang sesuai untuk ikon tersebut.
Berikut adalah contoh ikon khusus: