Halaman ini diterjemahkan oleh Cloud Translation API.

LiveChatMessages: insert

Menambahkan pesan atau polling ke live chat.

Kasus penggunaan umum

Permintaan

Permintaan HTTP

POST https://www.googleapis.com/youtube/v3/liveChat/messages

Otorisasi

Permintaan ini memerlukan otorisasi dengan setidaknya salah satu cakupan berikut (baca lebih lanjut tentang autentikasi dan otorisasi).

Cakupan
`https://www.googleapis.com/auth/youtube`
`https://www.googleapis.com/auth/youtube.force-ssl`

Parameter

Tabel berikut mencantumkan parameter yang didukung kueri ini. Semua parameter yang tercantum adalah parameter kueri.

Parameter
Parameter yang diperlukan
`part`	`string` Parameter `part` memiliki dua fungsi. Ini mengidentifikasi properti yang akan disetel oleh operasi tulis serta properti yang akan disertakan oleh respons API. Setel nilai parameter ke `snippet`.

Isi permintaan

Berikan resource liveChatMessage dalam isi permintaan. Untuk resource tersebut, Anda harus menentukan nilai untuk properti ini

snippet.liveChatId
snippet.type - pilih salah satu opsi berikut: textMessageEvent atau pollEvent
Jika jenisnya adalah textMessageEvent, sertakan snippet.textMessageDetails.messageText
Jika jenisnya adalah pollEvent, sertakan snippet.pollDetails dengan nilai berikut:
- snippet.pollDetails.metadata.options.questionText
- Daftar snippet.pollDetails.metadata.options.optionText. Anda harus mencantumkan minimal dua item dan tidak lebih dari lima item. Item ditampilkan secara berurutan sesuai urutan yang tercantum.

Respons

Jika berhasil, metode ini akan menampilkan resource liveChatMessage dalam isi respons.

Error

Tabel berikut mengidentifikasi pesan error yang dapat ditampilkan API sebagai respons terhadap panggilan ke metode ini. Lihat dokumentasi pesan error untuk mengetahui detail selengkapnya.

Jenis error	Detail error	Deskripsi
`forbidden (403)`	`forbidden`	Anda tidak memiliki izin yang diperlukan untuk membuat pesan yang ditentukan.
`forbidden (403)`	`liveChatDisabled`	Live chat yang ditentukan telah dinonaktifkan oleh pemilik, yang berarti pesan tidak dapat ditambahkan ke chat.
`forbidden (403)`	`liveChatEnded`	Live chat yang ditentukan tidak lagi live.
`invalidValue (400)`	`messageTextInvalid`	Teks pesan (`snippet.textMessageDetails.messageText`) tidak valid.
`notFound (404)`	`liveChatNotFound`	Live chat yang diidentifikasi dalam permintaan API tidak ada. Error ini terjadi jika chat telah dihapus oleh pemilik.
`required (400)`	`liveChatIdRequired`	Resource liveChatMessage harus menyertakan dan menentukan nilai untuk properti `snippet.liveChatId`.
`required (400)`	`messageTextRequired`	Resource liveChatMessage harus menyertakan dan menentukan nilai untuk properti `snippet.textMessageDetails.messageText`.
`required (400)`	`typeRequired`	Resource liveChatMessage harus menyertakan dan menentukan nilai untuk properti `snippet.type`. Setel nilai parameter ke `text`
`required (400)`	`preconditionCheckFailed`	Jajak pendapat aktif yang disematkan sudah ada.
`rateLimitExceeded`	`rateLimitExceeded`	Pengguna memposting terlalu banyak pesan chat dalam jangka waktu tertentu.

Cobalah!

Gunakan APIs Explorer untuk memanggil API ini serta melihat permintaan dan respons API.