- Permintaan HTTP
- Parameter lokasi
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- MessageReplyOption
- Cobalah!
Membuat pesan di ruang Google Chat. Untuk contoh, lihat Mengirim pesan.
Metode create()
memerlukan autentikasi pengguna atau aplikasi. Chat mengatribusikan pengirim pesan secara berbeda bergantung pada jenis autentikasi yang Anda gunakan dalam permintaan Anda.
Gambar berikut menunjukkan cara Chat mengatribusikan pesan saat Anda menggunakan autentikasi aplikasi. Chat menampilkan aplikasi Chat sebagai pengirim pesan. Konten pesan dapat berisi teks (text
), kartu (cardsV2
), dan widget aksesori (accessoryWidgets
).
Gambar berikut menunjukkan cara Chat mengatribusikan pesan saat Anda menggunakan autentikasi pengguna. Chat menampilkan pengguna sebagai pengirim pesan dan mengatribusikan aplikasi Chat ke pesan dengan menampilkan namanya. Konten pesan hanya boleh berisi teks (text
).
Ukuran pesan maksimum, termasuk konten pesan, adalah 32.000 byte.
Permintaan HTTP
POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
parent |
Wajib diisi. 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. Menentukan ID permintaan yang ada akan menampilkan pesan yang dibuat dengan ID tersebut, bukan membuat pesan baru. |
messageReplyOption |
Opsional. Menentukan apakah pesan memulai rangkaian pesan atau membalas rangkaian pesan. Hanya didukung di ruang yang diberi nama. |
messageId |
Opsional. ID kustom untuk pesan. Memungkinkan aplikasi Chat mendapatkan, mengupdate, atau menghapus pesan tanpa perlu menyimpan ID yang ditetapkan sistem dalam nama resource pesan (diwakili dalam kolom Nilai untuk kolom ini harus memenuhi persyaratan berikut:
Untuk mengetahui detailnya, lihat Memberi nama 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. Menggunakan opsi ini akan mengabaikan thread ID atau yang disertakan. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
Membuat pesan sebagai balasan untuk rangkaian pesan yang ditentukan oleh thread ID atau . Jika gagal, pesan akan memulai rangkaian pesan baru. |
REPLY_MESSAGE_OR_FAIL |
Membuat pesan sebagai balasan untuk 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. |