Method: spaces.messages.create

Membuat pesan di ruang Google Chat. Untuk contohnya, lihat Membuat 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

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 rangkaian pesan. Mendukung hingga 4.000 karakter. Untuk memulai atau menambahkan ke rangkaian pesan, buat pesan dan tentukan threadKey atau thread.name. Sebagai contoh penggunaan, lihat Memulai atau membalas rangkaian pesan.

requestId

string

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

enum (MessageReplyOption)

Opsional. Menentukan apakah pesan memulai rangkaian pesan atau membalasnya. Hanya didukung di ruang yang dinamai.

messageId

string

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 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 tidak.
  • Berisi hingga 63 karakter dan hanya huruf kecil, angka, dan tanda hubung.
  • Bersifat unik dalam ruang. Aplikasi Chat tidak dapat menggunakan ID kustom yang sama untuk pesan yang berbeda.

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 threadKey yang disertakan.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Membuat pesan sebagai balasan ke 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 ke 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.