- Permintaan HTTP
- Parameter lokasi
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- MessageReplyOption
- Cobalah!
Membuat pesan di ruang Google Chat. Ukuran pesan maksimum, termasuk teks dan kartu, adalah 32.000 byte. Untuk contohnya, lihat Mengirim pesan.
Memanggil metode ini memerlukan autentikasi dan mendukung jenis autentikasi berikut:
- Untuk pesan teks, autentikasi pengguna atau autentikasi aplikasi didukung.
- Untuk pesan kartu, hanya autentikasi aplikasi yang didukung. (Hanya aplikasi Chat yang dapat membuat pesan kartu.)
Permintaan HTTP
POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
parent |
Wajib. Nama resource ruang tempat membuat pesan. Format: |
Parameter kueri
Parameter | |
---|---|
threadKey |
Opsional. Tidak digunakan lagi: Sebagai gantinya, gunakan |
requestId |
Opsional. ID permintaan unik untuk pesan ini. Menetapkan ID permintaan yang ada akan mengembalikan pesan yang dibuat dengan ID tersebut, bukan membuat pesan baru. |
messageReplyOption |
Opsional. Menentukan apakah pesan memulai rangkaian pesan atau membalasnya. Hanya didukung di ruang yang dinamai. |
messageId |
Opsional. ID kustom untuk pesan. Mengizinkan aplikasi Chat mendapatkan, mengupdate, atau menghapus pesan tanpa perlu menyimpan ID yang ditetapkan sistem di nama resource pesan (ditampilkan di kolom Nilai untuk kolom ini harus memenuhi persyaratan berikut:
Untuk mengetahui detailnya, baca Menamai pesan. |
Isi permintaan
Isi permintaan memuat instance Message
.
Isi respons
Jika berhasil, isi respons memuat instance Message
yang baru dibuat.
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.create
Untuk informasi selengkapnya, lihat Panduan otorisasi.
MessageReplyOption
Menentukan cara membalas pesan. Negara bagian lainnya mungkin akan ditambahkan di masa mendatang.
Enum | |
---|---|
MESSAGE_REPLY_OPTION_UNSPECIFIED |
Default. Memulai rangkaian pesan baru. Penggunaan opsi ini akan mengabaikan thread ID atau yang disertakan. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
Membuat pesan sebagai balasan ke rangkaian pesan yang ditentukan oleh thread ID atau . Jika gagal, pesan akan memulai rangkaian pesan baru. |
REPLY_MESSAGE_OR_FAIL |
Membuat pesan sebagai balasan ke rangkaian pesan yang ditentukan oleh thread ID atau . Jika threadKey baru digunakan, thread baru akan dibuat. Jika pembuatan pesan gagal, error NOT_FOUND akan ditampilkan. |