Method: spaces.messages.create

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).

Pesan dikirim dengan autentikasi aplikasi

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).

Pesan dikirim dengan autentikasi pengguna

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

string

Wajib diisi. Nama resource ruang tempat membuat pesan.

Format: spaces/{space}

Parameter kueri

Parameter
threadKey
(deprecated)

string

Opsional. Tidak digunakan lagi: Sebagai gantinya, gunakan thread.thread_key. ID untuk thread. Mendukung hingga 4000 karakter. Untuk memulai atau menambahkan ke rangkaian pesan, buat pesan dan tentukan threadKey atau thread.name. Untuk mengetahui contoh penggunaannya, lihat Memulai atau membalas rangkaian pesan.

requestId

string

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

enum (MessageReplyOption)

Opsional. Menentukan apakah pesan memulai rangkaian pesan atau membalas rangkaian pesan. Hanya didukung di ruang yang diberi nama.

messageId

string

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 name pesan).

Nilai untuk kolom ini harus memenuhi persyaratan berikut:

  • Diawali dengan client-. Misalnya, client-custom-name adalah ID kustom yang valid, tetapi custom-name bukan.
  • Berisi maksimal 63 karakter dan hanya huruf kecil, angka, dan tanda hubung.
  • Unik dalam ruang. Aplikasi Chat tidak dapat menggunakan ID kustom yang sama untuk pesan yang berbeda.

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 threadKey yang disertakan.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Membuat pesan sebagai balasan untuk rangkaian pesan yang ditentukan oleh thread ID atau threadKey. 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 threadKey. Jika threadKey baru digunakan, thread baru akan dibuat. Jika pembuatan pesan gagal, error NOT_FOUND akan ditampilkan.