Method: spaces.messages.create

Membuat pesan. Sebagai contoh, lihat Membuat pesan.

Memerlukan autentikasi.

Pembuatan pesan teks mendukung autentikasi pengguna dan autentikasi aplikasi. Autentikasi pengguna memerlukan cakupan otorisasi chat.messages atau chat.messages.create.

Membuat pesan kartu memerlukan autentikasi aplikasi

Karena Chat memberikan autentikasi untuk webhook sebagai bagian dari URL yang dihasilkan saat webhook didaftarkan, webhook dapat membuat pesan tanpa akun layanan atau autentikasi pengguna.

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 thread buram. Untuk memulai atau menambahkan ke rangkaian pesan, buat pesan dan tentukan threadKey atau thread.name. Untuk penggunaan, 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 membalasnya. Hanya didukung di ruang bernama.
messageId

string

Opsional. Nama kustom untuk pesan Chat yang ditetapkan saat pembuatan. Harus diawali dengan client- dan hanya berisi huruf kecil, angka, dan tanda hubung yang panjangnya maksimum 63 karakter. Tentukan kolom ini untuk mendapatkan, memperbarui, atau menghapus pesan dengan nilai yang ditentukan. Menetapkan nama kustom memungkinkan aplikasi Chat mengingat pesan tanpa menyimpan pesan name dari isi respons yang ditampilkan saat membuat pesan. Menetapkan nama kustom tidak akan menggantikan kolom name yang dihasilkan, nama resource pesan. Sebaliknya, fitur ini menetapkan nama kustom sebagai kolom clientAssignedMessageId, yang dapat Anda referensikan saat memproses operasi berikutnya, seperti memperbarui atau menghapus pesan. Untuk penggunaan, lihat Menamai pesan yang dibuat.

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 mengetahui informasi selengkapnya, lihat Panduan otorisasi.

OpsiBalas Pesan

Menentukan cara membalas pesan. Status lainnya mungkin ditambahkan di masa mendatang.

Enumerasi
MESSAGE_REPLY_OPTION_UNSPECIFIED Default. Memulai rangkaian pesan.
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 gagal, error NOT_FOUND akan ditampilkan.