Memformat pesan

Halaman ini menjelaskan cara aplikasi Google Chat dapat memformat teks untuk mengirim pesan yang berisi salah satu dari hal berikut ini:

• Teks kaya yang berisi hyperlink atau @sebutan untuk satu atau semua pengguna dalam Ruang Chat.
• Teks yang muncul di antarmuka kartu, termasuk sebagai teks paragraf atau Teks UI yang ditampilkan di samping ikon, seperti tombol.

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 pesan teks, gunakan sintaksis berikut:

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:

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:

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:

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

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:

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 teks yang muncul di 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.

Gunakan Card Builder untuk mendesain dan melihat pratinjau pesan dan antarmuka pengguna untuk aplikasi Chat:

Memformat teks paragraf

Tag yang didukung dan tujuannya ditunjukkan dalam tabel berikut tabel:

Menambahkan ikon ke teks

Untuk menampilkan ikon di samping teks dalam kartu, Anda dapat menggunakan DecoratedText dan ButtonList widget.

Bagian berikut menjelaskan cara menggunakan ikon bawaan, yaitu Google Material ikon, atau ikon khusus dalam teks atau tombol yang dihias.

Menggunakan ikon dari Chat

Untuk menggunakan ikon bawaan yang tersedia di Chat, menentukan salah satu hal berikut:

Tabel berikut mencantumkan ikon bawaan yang tersedia untuk pesan kartu:

Tujuan berikut adalah contoh kartu dengan ikon email:

Menggunakan ikon Google Material

Anda dapat menggunakan ikon Material Google untuk memilih dari lebih dari 2500+ opsi ikon dan menyesuaikan bobot, isian, dan nilai ikon.

Berikut adalah contoh kartu dengan ikon Material Google:

Menggunakan ikon khusus

Untuk menambahkan ikon khusus, sertakan kolom iconUrl dan tentukan nama URL yang sesuai.

Berikut adalah contoh ikon khusus: