Halaman ini diterjemahkan oleh Cloud Translation API.

Memformat pesan

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~	~~halo~~
Monospace	` (petik tunggal terbalik)	`halo`	`hello`
Blok monospace	` ` ` (tiga tanda kutip terbalik)	``` Halo Dunia ```	`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 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 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:

Pesan diterima di Chat dengan kata

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:

Draf pesan dengan 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*?",
    }

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>`	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:

Aplikasi Chat menyebut seseorang dalam pesan teks.

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 interaksi MESSAGE.
Jika aplikasi Google Chat membuat pesan teks asinkron, Anda dapat menentukan nilai untuk users/{user} dengan cara berikut:
- Gunakan kolom name dari 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 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 Kartu

Tag 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 ~~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: 16-02-2023 15:00.
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
	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 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: