Method: spaces.messages.create

Membuat pesan di ruang Google Chat. Untuk mengetahui contohnya, lihat Membuat pesan.

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

requestId

string

Opsional. ID permintaan unik untuk pesan ini. Menentukan 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 dalam ruang yang diberi nama.

messageId

string

Opsional. ID kustom untuk pesan. Memungkinkan aplikasi Chat mendapatkan, memperbarui, atau menghapus pesan tanpa perlu menyimpan ID yang ditetapkan sistem di nama resource pesan (ditunjukkan 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 tidak.
  • Berisi hingga 63 karakter dan hanya huruf kecil, angka, dan tanda hubung.
  • Bersifat unik di 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 ditambahkan di masa mendatang.

Enum
MESSAGE_REPLY_OPTION_UNSPECIFIED Default. Memulai rangkaian pesan baru. Penggunaan opsi ini akan mengabaikan semua 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.